home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / pc_vt100.zip / PC-VT.DOC < prev    next >
Text File  |  1989-12-30  |  459KB  |  13,201 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                            (tm)
  18.                                       PC-VT
  19.  
  20.  
  21.                                     VT100/102/52
  22.                                          and
  23.                                       4010/4014
  24.  
  25.                                   Terminal Emulator
  26.  
  27.                                (C) Copyright 1985-1990
  28.                                   Mark C. DiVecchio
  29.                           Athena Systems Development Group
  30.  
  31.                                     Version 10.0
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.                      PC-VT is dedicated to my mother and father
  86.                        who, when they came to visit, could not
  87.                      understand why I spent so much time tapping
  88.                                  the keys of my PC.
  89.  
  90.                                                                       M.C.D.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.           Forward
  142.  
  143.  
  144.                   The PC-VT program and documentation were written  by Mark
  145.           C. DiVecchio.
  146.  
  147.                   Many trademarks are used through out this  document. They
  148.           are:
  149.  
  150.              -  PC-VT is a trademark of Mark C. DiVecchio.
  151.  
  152.              -  IBM,  IBM   PC,  IBM  AT  and  TopView  are  trademarks  of
  153.                 International Business Machines Corporation.
  154.  
  155.              -  DEC, VMS, VAX and  VT  are  trademarks of Digital Equipment
  156.                 Corporation.
  157.  
  158.              -  Smartmodem is a trademark of Hayes Microcomputer Products.
  159.  
  160.              -  UNIX is a trademark of AT&T Bell Laboratories, Inc.
  161.  
  162.              -  KERMIT is a trademark of Henson Associates, Inc.
  163.  
  164.              -  Tektronix is a trademark of Tektronix, Inc.
  165.  
  166.              -  The Everex Edge is a trademark of Everex Systems, Inc.
  167.  
  168.              -  Hercules is a trademark  of  Hercules  Computer Technology,
  169.                 Inc.
  170.  
  171.              -  DESQview is a trademark of Quarterdeck Office Systems.
  172.  
  173.                   For more details on the operation of a VT100 or  a VT102,
  174.           refer to the VT100 and VT102 Video Terminal User Guides available
  175.           from:
  176.  
  177.                             Digital Equipment Corporation
  178.                                     PO Box CS2008
  179.                                   Nashua, NH  03061
  180.                           VT100 : Part No. EK-VT100-UG-003
  181.                           VT102 : Part No. EK-VT102-UG-002
  182.                                     (800)258-1710
  183.  
  184.                   For complete details on the  operation  of  the 4010/4014
  185.           consult the "4014 and  4014-1  Computer  Display  Terminal User's
  186.           Manual" distributed by:
  187.  
  188.                                    Tektronix, Inc.
  189.                                      PO BOX 500
  190.                                 Beaverton, OR  97977
  191.                                 Part No. 070-1647-00.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                   For  details  on  the  Everex   Edge  Monochrome/Graphics
  206.           Adapter Card which gives PC-VT its 132 column capability and high
  207.           resolution 4014 emulation, you can contact Everex at:
  208.  
  209.                                 Everex Systems, Inc.
  210.                             47777 Warm Springs Boulevard
  211.                                   Fremont, CA 94539
  212.  
  213.                   For  details  on the Hercules  monochrome  graphics  card
  214.           which gives PC-VT its high  resolution  4014  emulation,  you can
  215.           contact Hercules at:
  216.  
  217.                             Hercules Computer Technology
  218.                                    2550 Ninth St.
  219.                                  Berkeley, CA 94710
  220.  
  221.                   KERMIT was developed at  Columbia  University  Center for
  222.           Computing  Activities  by   Frank da Cruz, Daphne Tzoar, and Bill
  223.           Catchings and is included here  at no charge because imitation is
  224.           the sincerest form  of  flattery. The supplement to this document
  225.           contains a copy of the KERMIT manual.
  226.  
  227.  
  228.  
  229.  
  230.                                      Conventions
  231.  
  232.  
  233.                   Throughout this manual, hexadecimal numbers  are followed
  234.           by the letter "H". All other numbers are decimal. Also, the Enter
  235.           key on the keyboard  sends  a  carriage  return character - ASCII
  236.           code  13.  A  carriage  return  function moves the cursor to  the
  237.           beginning  of  the  current  line.  "ESC"  refers  to  the  ASCII
  238.           character whose decimal value is 27.
  239.  
  240.                   The  word "frame" is used to mean what  you  see  on  the
  241.           screen.  It  is  a  collection  of  words  and symbols  providing
  242.           information. The word "display" is used to mean the screen itself
  243.           or the act of causing characters to be shown on the screen.
  244.  
  245.                   For the latest news  about  PC-VT,  read  the file on the
  246.           distribution diskette named READ.ME.
  247.  
  248.  
  249.           THANKS
  250.  
  251.  
  252.                   Your feedback helps  make  PC-VT a better and more useful
  253.           program. If you have  any  ideas or comments, please send them to
  254.           the address below.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                   Mark C. DiVecchio
  272.                           ATHENA SYSTEMS DEVELOPMENT GROUP
  273.                          9888 Carroll Center Road  Suite 113
  274.                                  San Diego, CA 92126
  275.                         (619) 549-4056  RBBS : (619) 549-3927
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.           PC-VT v10.0                                 VT100 & 4014 Emulator
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.                                       Chapter 1
  344.  
  345.                                     Introduction
  346.  
  347.  
  348.                   PC-VT emulates DEC VT100, DEC VT102, DEC  VT52, Tektronix
  349.           4010 and Tektronix 4014  terminals.  It runs on the IBM PC, PCXT,
  350.           PCjr, and PCAT under DOS 2.x and 3.x. PC-VT  is  compatible  with
  351.           both the DESQview and TopView multiprocessing software packages.
  352.  
  353.  
  354.           1.1  General Terminal Emulation
  355.  
  356.  
  357.                   Throughout this manual, host refers to  the  computer "on
  358.           the other end of the line" with which PC-VT is communicating.
  359.  
  360.                   PC-VT performs these functions  which  make  it  a useful
  361.           interface between a PC and a host computer:
  362.  
  363.              -   Communication over an RS232 port configured as either COM1
  364.                 or COM2 selectable from the SETUP frame.
  365.  
  366.              -  Communications support for all the  popular  baud  rate and
  367.                 data bit/parity bit combinations.
  368.  
  369.              -  On Line HELP by  pressing  the ALT-H key while in the VT100
  370.                 or 4014 communications, SETUP, DIALING, or MACRO frames.
  371.  
  372.              -  Full feature Upload and  Download  file  capability. ASCII,
  373.                 XMODEM (CRC capable), and KERMIT are  supported.  Path name
  374.                 support  is included. ASCII file upload includes  handshake
  375.                 capability to compensate for slow  host  systems.  User can
  376.                 set his preferred file  transfer  method  as the default in
  377.                 the SETUP B frame.
  378.  
  379.              -  Support for Hayes dialing commands and a  dialing directory
  380.                 with 10 entries. Each entry contains not only phone numbers
  381.                 and dialing commands but also a complete copy  of  the USER
  382.                 MEMORY file with which you  can  customize  PC-VT  for each
  383.                 host.  These customized  USER  MEMORIES  are  automatically
  384.                 loaded when PC-VT dials the phone number.
  385.  
  386.              -  ALT-F1 thru ALT-F10 are used as macro keys.
  387.  
  388.              -  DOS  functions  or  other  programs  can  be   run  without
  389.                 terminating  PC-VT   or   disconnecting   from   the  host.
  390.                 Especially  useful since PC-VT monitors the  communications
  391.  
  392.  
  393.                                                                      Page 1
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.           Introduction                                          PC-VT v10.0
  401.  
  402.  
  403.                 line  and  saves  all  characters  received  while  you are
  404.                 running other  programs.  When  you  return  to  PC-VT, the
  405.                 received information is displayed.
  406.  
  407.              -  Use  of  the  environment  string  "PC-VT="  to   find  the
  408.                 parameter  files.
  409.  
  410.              -  Supports buffer  sizes  of  256  and  2048  characters. The
  411.                 smaller buffers give faster response to  interrupts  to the
  412.                 host while the larger size reduces XON/XOFF handshaking.
  413.  
  414.              -  Full Duplex with no EIA modem control. Only data leads have
  415.                 to be connected (FDX A mode). Suitable for use with  a null
  416.                 modem (direct) connection to  the  host  computer or with a
  417.                 modem which does not require modem control signals.
  418.  
  419.              -  Full receive parity checking.
  420.  
  421.              -  Capability to transmit a sustained Break.
  422.  
  423.  
  424.           1.2  VT100/VT102/VT52
  425.  
  426.  
  427.                   PC-VT  is  a  software emulator which makes  the  IBM  PC
  428.           function  as a DEC VT102, VT100 or  VT52  video  terminal.  PC-VT
  429.           defaults to VT102 emulation.
  430.  
  431.                   In  this  manual,  reference   to   the   VT100  emulator
  432.           encompasses the VT100/VT102/VT52 emulator package.
  433.  
  434.                   PC-VT  emulates the majority of the documented  functions
  435.           of the VT100. Because of either hardware limitations  of  the IBM
  436.           PC  or limitations of DOS, some  functions  cannot  be  emulated.
  437.           Other  functions  have been slightly  modified.  Throughout  this
  438.           document, references are made to these changes and deletions. The
  439.           vast majority of users will never notice these  hardware  and DOS
  440.           mandated changes.
  441.  
  442.                   The VT user will  only  need to read Chapters 2 through 5
  443.           of this manual. Chapter 6, SETUP frames, is only necessary if any
  444.           of  the  selectable  features  need  to be changed  from  default
  445.           settings. Chapter 7 describes the VT100 "USER MEMORY" which PC-VT
  446.           emulates by creating and using a disk file.  The  Appendices give
  447.           more sophisticated users a complete description  of  the internal
  448.           workings of the VT mode of PC-VT.
  449.  
  450.                   The  following is a brief list  of  the  VT100  functions
  451.           handled by PC-VT:
  452.  
  453.              -  Emulates  both  VT100 and VT102  terminals.  Emulates  VT52
  454.                 compatibility mode of the VT100.
  455.  
  456.  
  457.  
  458.  
  459.           Page 2
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.           PC-VT v10.0                                 VT100 & 4014 Emulator
  467.  
  468.  
  469.              -  Fast screen update for PC's with the color graphics display
  470.                 card. Known as  snow  update. A separate option is provided
  471.                 to select fast screen mode  (known as DMA) for screen saves
  472.                 and restores only and not for normal character display.
  473.  
  474.              -  Handles 8 foreground and 8  background  colors  on  a color
  475.                 monitor. User can set his color choices from the host.
  476.  
  477.              -  Selects either VMS or UNIX host. PC-VT supports EDT and EVE
  478.                 under VMS and VI under UNIX mode.
  479.  
  480.              -  Supports VMS 4.x Line Editing using the PC's Keypad.
  481.  
  482.              -  Copy the screen to a disk file at any time.
  483.  
  484.              -  NO SCROLL key XON/XOFF support. Can recall up to 8 previous
  485.                 screens of information and dump  all  of  those  screens to
  486.                 disk upon request.
  487.  
  488.              -  Ability to redefine  all  function and editing keys to send
  489.                 any text or Escape sequence of up to 50 characters.
  490.  
  491.              -  Connects a printer as LPT1 or LPT2 and includes local print
  492.                 screen operations.
  493.  
  494.              -  Capability to echo all displayed characters to LPT1 or LPT2
  495.                 as a hardcopy record of a terminal session.
  496.  
  497.              -  Screen blanking feature turns  off  the  CRT screen after 3
  498.                 minutes of inactivity.
  499.  
  500.              -  Special  ALT  key combinations provide  access  to  several
  501.                 special function procedures.
  502.  
  503.              -  SETUP A and  SETUP  B  frames  to  configure  PC-VT  to the
  504.                 operating environment.
  505.  
  506.              -  Both Numeric and Application Keypad modes.
  507.  
  508.              -  Full cursor control.
  509.  
  510.              -  Full XON/XOFF support for both transmit and receive.
  511.  
  512.              -  ON  LINE,  LED  "Lx" and KBD LOCKED lights are supported on
  513.                 line 25 of the PC's screen  as  a Status Line. (4 LED's are
  514.                 supported for both the VT100 and VT102 emulation.)
  515.  
  516.              -  132  column mode is supported if  you  have  installed  the
  517.                 Everex Edge card in your PC.
  518.  
  519.              -  Double width characters are  simulated  by  displaying them
  520.                 with a space between them so that 40 characters take up one
  521.                 entire 80 character line.
  522.  
  523.  
  524.  
  525.                                                                      Page 3
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.           Introduction                                          PC-VT v10.0
  533.  
  534.  
  535.              -  Double height characters are simulated by clearing  the top
  536.                 half line to blanks and making the bottom half line  into a
  537.                 double width line.
  538.  
  539.                   The following functions are not handled by PC-VT in VT100
  540.           mode:
  541.  
  542.              -  VT100 half duplex modes (HDX A and HDX B) and  special full
  543.                 duplex modes (FDX B and FDX C).
  544.  
  545.              -  Features  used only  in  these  unsupported  communications
  546.                 modes.
  547.  
  548.              -  VT100  Tests  and  Adjustments  Escape  sequences  are  not
  549.                 actually run on the PC.  PC-VT does respond with a terminal
  550.                 OK Device Status Report.
  551.  
  552.              -  Certain display attribute handling.  The  IBM  PC  does not
  553.                 handle reverse video (black on white) the same  way  as the
  554.                 VT100. It will look  the  same  on  the screen but changing
  555.                 from  one to the other mode will be  slower  and  will  not
  556.                 produce the expected results. Underline especially produces
  557.                 unusual results. The underscore attribute on PC's using the
  558.                 color graphics  display  card  is  displayed  with  bold or
  559.                 bold/blinking attributes selectable from the SETUP B frame.
  560.                 Look Appendix B for details of what combinations work.
  561.  
  562.              -  As mentioned  earlier,  functions  for  which  there  is no
  563.                 essential hardware such as Smooth Scroll  mode,  132 column
  564.                 mode, and Alternate Character ROM  modes  are  not handled.
  565.                 132  column  mode  will work if you install the Everex Edge
  566.                 card.
  567.  
  568.              -  Double height and double  width  characters  are simulated.
  569.                 The emulation is not exact.
  570.  
  571.              -  The line printer serves  as  a  capture device only. Escape
  572.                 sequences are not sent to the line printer.
  573.  
  574.  
  575.           1.3  4010/4014
  576.  
  577.  
  578.                   PC-VT includes a software emulator which makes the IBM PC
  579.           function as a Tektronix 4010/4014 Computer Display Terminal.
  580.  
  581.                   In   this   manual,   reference   to  the  4014  emulator
  582.           encompasses the Tektronix 4010/4014 emulator package.
  583.  
  584.                   PC-VT emulates the majority of the functions of the 4014.
  585.           Because  of   either  hardware  limitations  of  the  IBM  PC  or
  586.           limitations of DOS,  some  functions  cannot  be  emulated. Other
  587.           functions have been slightly modified. The differences are listed
  588.           below.
  589.  
  590.  
  591.           Page 4
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.           PC-VT v10.0                                 VT100 & 4014 Emulator
  599.  
  600.  
  601.                   The 4014 user normally only  needs to read Chapters 2 and
  602.           11  to understand  the  operation of the 4014 emulator. Chapter 6
  603.           is only necessary if any of the selectable features  need  to  be
  604.           changed from the default settings.  PC-VT  defaults  to  the most
  605.           commonly used  set  of  features.  The  Appendices  give detailed
  606.           technical descriptions of the operation of PC-VT.
  607.  
  608.                   The 4014 emulator requires the IBM Color Graphics Adapter
  609.           (CGA) (or equivalent),  the Everex Edge Monochrome/Color Graphics
  610.           Adapter or the Hercules Graphics  Card  (or  equivalent).  If you
  611.           have  both the IBM Monochrome and  IBM  Color  Graphics  Adapters
  612.           along  with two displays, PC-VT will use both  of  them  in  4014
  613.           mode.
  614.  
  615.           PC-VT handles the following 4014 functions :
  616.  
  617.              -  Emulates both Tektronix 4010 and 4014 terminals.
  618.  
  619.                 Since the PC screen  is  not the same as the Tektronix 4014
  620.                 screen,  the following adjustment is made (high  resolution
  621.                 coordinates are shown in parentheses):
  622.  
  623.                 For the 4010:
  624.                 X scale = Tekpoints 0-1023 are mapped into PC 0-639(720)
  625.                 Y scale = Tekpoints 0-779  are mapped into PC 0-199(348)
  626.                           Y points 780-1023 map above the screen
  627.                           but are still valid.
  628.  
  629.                 For the 4014:
  630.                 X scale = Tekpoints 0-4095 are mapped into PC 0-639(720)
  631.                 Y scale = Tekpoints 0-3119 are mapped into PC 0-199(348)
  632.                           Y points 3120-4095 map above the screen
  633.                           but are still valid.
  634.  
  635.              -  Supports Alpha mode, Graph mode, Point  Plot  mode, Special
  636.                 Point Plot mode, Incremental Plot mode, and GIN mode.
  637.  
  638.              -  Handles  both  0-1023  (4010)  and 0-4096 (4014) coordinate
  639.                 spaces.
  640.  
  641.              -  Draws normal, dotted, dot-dashed, short-dash, and long-dash
  642.                 vectors.
  643.  
  644.              -  Supports  write thru mode by exclusive-ORing vectors  drawn
  645.                 in   that   mode   into   the  screen.  Therefore,  vectors
  646.                 continually drawn in  write  thru mode will appear to blink
  647.                 on the screen.
  648.  
  649.              -  Connects a printer as LPT1 or LPT2 and includes local print
  650.                 screen  operations.  The  IBM supplied GRAPHICS.COM program
  651.                 must have been run first as it is used for printing the CGA
  652.                 screen. The high resolution  screen  is  printed  by PC-VT,
  653.                 eliminating the need to run GRAPHICS.COM.
  654.  
  655.  
  656.  
  657.                                                                      Page 5
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.           Introduction                                          PC-VT v10.0
  665.  
  666.  
  667.              -  Handles Page-Full and Autoprint operations.
  668.  
  669.              -  SCROLL LOCK key pauses vector drawing.
  670.  
  671.              -  Unlike a real 4014, PC-VT handles XON and XOFF like a VT100
  672.                 even in 4014 mode.  If  you  do  not want this handshaking,
  673.                 disable the XON/XOFF feature in the SETUP B frame.
  674.  
  675.           PC-VT can not handle the following items in 4014 mode:
  676.  
  677.              -  Margin  2  is  not  implemented.  Page  Full  condition  is
  678.                 selected when a line  feed  is output on the bottom line of
  679.                 the screen.
  680.  
  681.              -  The IBM PC does not display an Alpha cursor when the screen
  682.                 is in graphics mode.
  683.  
  684.              -  The alternate character set is not supported.
  685.  
  686.              -  PC-VT generates two character sets  when  using  either the
  687.                 IBM CGA, the Everex  Edge  or  the Hercules Graphics cards.
  688.                 The larger set is 8x8 dots and the smaller is 6x6 dots. The
  689.                 smaller set contains capital letters only.
  690.  
  691.              -  The IBM CGA supports 25 lines by 80 columns and 33 lines by
  692.                 106 columns. When using the  high  resolution  mode  of the
  693.                 Everex Edge or  Hercules  cards, PC-VT supports 43 lines by
  694.                 90 columns and 58 lines by 120 columns.
  695.  
  696.              -  Defocused  mode  is   not  supported.  Handled  as  regular
  697.                 vectors.
  698.  
  699.              -  Varying intensity vectors are not  supported.  Only  0% and
  700.                 100% intensity are supported.
  701.  
  702.              -  Special  Point  Plot  mode  responds  to  all  vectors with
  703.                 intensity  greater  than  0%   as   100%.   There   are  no
  704.                 intermediate intensity levels.
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.           Page 6
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.           PC-VT v10.0                                 VT100 & 4014 Emulator
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.                                       Chapter 2
  740.  
  741.                            Required Hardware and Software
  742.  
  743.  
  744.                   PC-VT requires an IBM PC, PCXT, PCjr, or PCAT with either
  745.           the  IBM  Monochrome  or  Color/Graphics  adapter,  an  80 column
  746.           screen, 128K of memory (enough for DOS plus about 58K for the PC-
  747.           VT program and about 23K for the HELP frame), one disk  drive and
  748.           one RS-232 port. The RS-232 port can be jumpered as COM1 or COM2.
  749.           A line printer, if present, is supported if it is connected  to a
  750.           parallel  port  jumpered  as  either  LPT1 or LPT2. The DOS  MODE
  751.           command can be used to route LPT1 or LPT2 output to a COM port if
  752.           a  serial  printer  is attached. PC-VT operated under DOS 2.x, or
  753.           3.x. PC-VT runs from either  floppy diskette or fixed disk. PC-VT
  754.           is not copy protected.
  755.  
  756.                   To run the  4014  emulator, PC-VT requires either the IBM
  757.           Color  Graphics  Adapter  and a color monitor,  the  Everex  Edge
  758.           Monochrome/Color  Graphics Adapter and an IBM monochrome  monitor
  759.           or the Hercules Graphics Card and an IBM monochrome monitor.
  760.  
  761.                   To use 132 columns in the VT emulator requires the Everex
  762.           Edge  Monochrome/Color  Graphics Adapter and  an  IBM  monochrome
  763.           monitor.
  764.  
  765.                   To use  the  Scroll  Buffer  feature,  PC-VT  requires an
  766.           additional 88K of memory to hold the recalled screen information.
  767.           To  run  the  KERMIT  file  transfer  module,  PC-VT requires  an
  768.           additional 83K of memory.
  769.  
  770.                   The ANSI.SYS  device  driver  is  not  needed.  When it's
  771.           loaded, it will not  interfere  with PC-VT but will slow down the
  772.           program   operation.   PC-VT   will   not    recognize   keyboard
  773.           redefinitions performed by ANSI.SYS.
  774.  
  775.                   PC-VT supports the  Hayes Smartmodem or compatible cards.
  776.           Chapter 9 gives the details for their use. The modem card  can be
  777.           configured as COM1  or  COM2.  If  an external modem is used, the
  778.           RS-232 port in the IBM PC  can  also be configured either as COM1
  779.           or COM2.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                                                      Page 7
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.           Required Hardware and Software                        PC-VT v10.0
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.           Page 8
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.           PC-VT v10.0                                 VT100 & 4014 Emulator
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.                                       Chapter 3
  872.  
  873.                             Installing and Starting PC-VT
  874.  
  875.  
  876.           3.1  Installation
  877.  
  878.  
  879.                   First, make  a  backup  of  the  diskette  containing the
  880.           program and support files. Place  the original diskette in a safe
  881.           place and use it only to make additional working copies of PC-VT.
  882.  
  883.  
  884.           3.1.1  Floppy Diskette Installation
  885.  
  886.  
  887.                   Insert the diskette into one of your diskette drives. Set
  888.           the default diskette letter in DOS to that drive.
  889.  
  890.                   PC-VT  creates  and  uses three files on the disk to save
  891.           default  parameters.  The  files  are PARAMS.DAT, DIALER.DAT, and
  892.           MACRO.DAT. These files are automatically created  on  the default
  893.           drive when you start the program for the first time.
  894.  
  895.  
  896.           3.1.2  Fixed Disk Installation
  897.  
  898.  
  899.                   Using PC-VT on the IBM  fixed disk is the most convenient
  900.           way to use the program. There are no  special  requirements. Copy
  901.           the program PC-VT.EXE and the file HELP.DAT to the fixed disk and
  902.           using the SET command as described below. If you are going to run
  903.           KERMIT file transfers, copy KERMIT.COM to the fixed disk.
  904.  
  905.                   PC-VT  creates  and  uses three files on the disk to save
  906.           default  parameters.  The  files  are PARAMS.DAT, DIALER.DAT, and
  907.           MACRO.DAT. These files are automatically created  in  the default
  908.           directory  on the default drive. A better  way  to  handle  these
  909.           files  is  to  specify an environment string  telling  PC-VT  the
  910.           directory  to  store  these  three  files.  You  should copy  the
  911.           KERMIT.COM into this directory as  well. You can specify the PATH
  912.           command which DOS uses to locate the PC-VT  program  itself. With
  913.           these two features, you can execute PC-VT without  regard  to the
  914.           current default directory set on your fixed disk.
  915.  
  916.                   Use the DOS SET command as follows:
  917.  
  918.           SET PC-VT=d:path
  919.  
  920.  
  921.                                                                      Page 9
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.           Installing and Starting PC-VT                         PC-VT v10.0
  929.  
  930.  
  931.                   Where "d" is the drive letter and "path" is the pathname.
  932.           The pathname can  be  any  string  acceptable  to  the  DOS CHDIR
  933.           command. Some examples:
  934.  
  935.           SET PC-VT=              PC-VT uses the default
  936.                                   directory on the default disk.
  937.  
  938.           SET PC-VT=C:            PC-VT uses the default
  939.                                   directory on the C drive.
  940.  
  941.           SET PC-VT=A:\           PC-VT uses the root
  942.                                   directory on the A drive.
  943.  
  944.           SET PC-VT=C:\PC-VT      PC-VT uses the directory
  945.                                   named PC-VT on the C drive.
  946.  
  947.                   Again, if you  don't  bother with this option, PC-VT just
  948.           uses the default directory on the default drive.
  949.  
  950.                   Here is an example of a command sequence used to load PC-
  951.           VT onto a fixed disk. Put the diskette containing the program and
  952.           support files into the A diskette drive. Replace the drive letter
  953.           C in the example with the drive letter of your fixed disk.
  954.  
  955.           C:
  956.           CD \
  957.           MKDIR PC-VT
  958.           SET PATH=C:\;C:\PC-VT
  959.           SET PC-VT=C:\PC-VT
  960.           COPY A:PC-VT.EXE C:\PC-VT/V
  961.           COPY A:HELP.DAT C:\PC-VT/V
  962.           COPY A:KERMIT.COM C:\PC-VT/V
  963.  
  964.                   Now you can  execute  PC-VT without regard to the current
  965.           default directory.
  966.  
  967.  
  968.           3.2  Starting PC-VT
  969.  
  970.  
  971.                   If you have  a  modem which requires manual dialing, dial
  972.           up the host computer and turn on the modem. Start the  program by
  973.           typing PC-VT. PC-VT is preinitialized to communicate at 1200 baud
  974.           with 8 data bits, no parity, and 1 stop bit  through  COM port 1.
  975.           If these parameters are not correct for your installation you can
  976.           change  them.   See  the  discussion  of  the  SETUP  frames  for
  977.           instructions on how to change parameters.
  978.  
  979.                   As  PC-VT starts up, it initializes  the  COMx  port  and
  980.           establishes the  connection to the modem. The screen displays the
  981.           communications frame. Lines 1 through 24 emulate the VT100 screen
  982.           which has 24 lines. Line 25 is a  Status  Line.  The  first thing
  983.           that you  see  on  line  25 is the word "ON LINE" and the version
  984.           number of PC-VT in the lower left.  This indicates that  PC-VT is
  985.  
  986.  
  987.           Page 10
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.           PC-VT v10.0                                 VT100 & 4014 Emulator
  995.  
  996.  
  997.           operating normally and is  ready  to  communicate.  If you have a
  998.           Hayes or Hayes  compatible  modem, you can now automatically dial
  999.           the host's number. Press CTRL-F9  to enter the DIALING frame. See
  1000.           Chapter  9  for  detailed instructions on how to use this dialing
  1001.           facility. Most host systems require  that  the  terminal initiate
  1002.           communications, so  press ENTER once or twice. Your host computer
  1003.           should now be responding. From this point on, PC-VT runs  your PC
  1004.           as a VT100 video terminal.
  1005.  
  1006.                   In addition to the items described above, the Status Line
  1007.           also shows the status of the  attached  modem if the cable to the
  1008.           modem carries all  signals  or  if  the  modem  is  an internally
  1009.           mounted unit. These three icons are displayed:
  1010.  
  1011.              -  DSR - Data Set Ready - the modem is ready to accept data.
  1012.  
  1013.              -  CD - Carrier Detect  -  the modem has detected a carrier on
  1014.                 the phone line.
  1015.  
  1016.              -  CTS  -  Clear  To  Send  -  the  modem  has  established  a
  1017.                 connection and is ready to send data to the host.
  1018.  
  1019.                   If  you  are  using a intelligent modem,  the  modem  may
  1020.           signal CD and CTS even when  not  connected to the host. There is
  1021.           usually a switch on the modem to switch these two lines  to their
  1022.           correct operation. Keep in mind  that  PC-VT  doesn't  care about
  1023.           these lines, it just displays them for your information.
  1024.  
  1025.                   The CD and DSR lines can  be  used by the dialer during a
  1026.           modem dial operation. See Chapter 9 for dialer details.
  1027.  
  1028.                   A  new  copy  of  Command.COM  can  be   started  without
  1029.           terminating PC-VT or breaking  the  host  connection. To do this,
  1030.           press ALT-F (hold down the ALT key and then press the F key). The
  1031.           contents of the communications frame  is saved by PC-VT. Then the
  1032.           screen clears and a DOS prompt appears on the screen. You can now
  1033.           execute all DOS commands  and  even  start  up other programs. Be
  1034.           careful, though, that you do not run a program that uses the same
  1035.           communications port or disk  files  as  being  used by PC-VT. The
  1036.           other program may leave the  communications  port  in  an unknown
  1037.           state and PC-VT may not be able to regain control of it. When you
  1038.           wish  to  return  to PC-VT, type "exit" at the Command.COM prompt
  1039.           and control returns to the PC-VT communications frame.
  1040.  
  1041.                   PC-VT uses the environment  string  "COMSPEC="  to locate
  1042.           the  command  processor.   Since   DOS   sets   this   string  up
  1043.           automatically, you don't have  to  concern  yourself with it. The
  1044.           most useful reason for getting back to DOS by this method instead
  1045.           of  terminating  PC-VT  is  that  PC-VT  remains  in  memory  and
  1046.           constantly monitors the communications port. Then when you return
  1047.           to  PC-VT  by  typing  "exit",  PC-VT  immediately  displays  all
  1048.           information which it received  and  saved  while you were running
  1049.           other  DOS programs. Of course, if you  terminate  PC-VT  to  run
  1050.           other  DOS  programs,  PC-VT  is  cleared  from  memory  and  the
  1051.  
  1052.  
  1053.                                                                     Page 11
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.           Installing and Starting PC-VT                         PC-VT v10.0
  1061.  
  1062.  
  1063.           communications port  is  no  longer  monitored.  All  information
  1064.           received on the port is lost.
  1065.  
  1066.                   PC-VT outputs both tones  and  clicks  on the internal PC
  1067.           speaker  to  indicate  attempted  illegal operations. PC-VT beeps
  1068.           under the following conditions:
  1069.  
  1070.             1.  when an undefined key is pressed on the keyboard,
  1071.  
  1072.             2.  when a control character of ASCII 7 (BEL) is received,
  1073.  
  1074.             3.  when margin bell has been selected in the SETUP B frame and
  1075.                 the  cursor  enters  the 8th column from the right from the
  1076.                 9th column from the right  under control of the keyboard or
  1077.                 the host,
  1078.  
  1079.             4.  when the host tries  to  output to the line printer and the
  1080.                 line printer is not ready,
  1081.  
  1082.             5.  when an attempt is made  to perform an illegal or undefined
  1083.                 operation in the SETUP, DIALING or MACRO frames, or
  1084.  
  1085.             6.  when the modem has lost communications or  cannot transmit,
  1086.                 PC-VT times out after trying to send a  character  for one-
  1087.                 half second.
  1088.  
  1089.           PC-VT clicks under the following conditions:
  1090.  
  1091.             1.  when the keyboard has been locked by the host and a  key is
  1092.                 typed or
  1093.  
  1094.             2.  when the user requests a BREAK to be sent to host.
  1095.  
  1096.  
  1097.           3.3  Command Line Options
  1098.  
  1099.  
  1100.                   When you start up PC-VT by typing the program name at the
  1101.           DOS  command  prompt,  you can follow the name with the following
  1102.           command line options. You must do  this  at least once if you are
  1103.           using  the  Everex  Edge or Hercules Graphics cards. To make your
  1104.           selections permanent once you have started PC-VT, go to the SETUP
  1105.           A frame  and  press  "S"  to  save  this information in your USER
  1106.           MEMORY on disk. Then when you next start PC-VT, the selected mode
  1107.           will be automatically started.
  1108.  
  1109.  
  1110.           /g             tells PC-VT not to display the opening  banner but
  1111.                          to go directly into the communications frame.
  1112.  
  1113.           /dn            tells PC-VT to  dial  the  number  in  the DIALING
  1114.                          frame corresponding to n, where n is a number from
  1115.                          1  to 10. PC-VT takes the  entry  in  the  DIALING
  1116.                          directory and dials the number during its start up
  1117.  
  1118.  
  1119.           Page 12
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1127.  
  1128.  
  1129.                          sequence.  This  lets you start  the  program  and
  1130.                          immediately  dial a number. The dialing entry  can
  1131.                          be a complete  logon  macro  as  described  in the
  1132.                          Chapter 9.
  1133.  
  1134.           /ln            tells PC-VT to load the SETUP data for the host in
  1135.                          the DIALING frame corresponding to n, where n is a
  1136.                          number from 1 to 10.  PC-VT takes the entry in the
  1137.                          DIALING directory and  loads the SETUP data during
  1138.                          its start up sequence.  This  lets  you  start the
  1139.                          program and have the SETUP data  for  a particular
  1140.                          host. This  is useful if you are already dialed in
  1141.                          to a host and  just  want to reset PC-VT or if you
  1142.                          are on a direct connection to a host.
  1143.  
  1144.           /c             tells PC-VT to  use the other communications port.
  1145.                          That is, if the default you have set is COM1, when
  1146.                          PC-VT starts, it uses COM2.
  1147.  
  1148.           /t             causes  PC-VT  to  immediately  go into 4014 mode.
  1149.                          Normally, PC-VT starts up in  VT100  mode  and you
  1150.                          must switch it to 4014 mode by pressing ALT-T.
  1151.  
  1152.           /b             tells PC-VT that you have both the  IBM monochrome
  1153.                          and IBM Color Graphics Adapter installed. That way
  1154.                          you can  use  the  monochrome  display  for  VT100
  1155.                          emulation  and  the  graphics  display   for  4014
  1156.                          emulation.  The  displays  are  not cleared as you
  1157.                          switch between emulators. To  let  PC-VT  make the
  1158.                          most of this mode, you  should  start  the program
  1159.                          from the monochrome display.
  1160.  
  1161.           /e             tells  PC-VT  that  you   have   an   Everex  Edge
  1162.                          Monochrome/Color Graphics Adapter Card with an IBM
  1163.                          monochrome monitor installed in your PC. With this
  1164.                          card, PC-VT  can  display  the  132  column  VT100
  1165.                          screen, the regular 80 column screen and  the 4014
  1166.                          high  resolution  graphic  screens  on   the  same
  1167.                          display. The display is automatically  switched as
  1168.                          you switch emulators. Caution : If you select this
  1169.                          option and you do  not  have  the Everex Edge card
  1170.                          installed,  the  results are  unpredictable.  This
  1171.                          mode  REQUIRES  the  IBM  monochrome   monitor  be
  1172.                          connected to the Edge card.
  1173.  
  1174.           /h             tells PC-VT that you have  either  an  Everex Edge
  1175.                          Monochrome/Color  Graphics  Adapter  or a Hercules
  1176.                          Graphics Card installed in your PC. PC-VT produces
  1177.                          4014 graphics using the  720  by  348  pixel modes
  1178.                          supported by these cards. You  don't  have  to use
  1179.                          this  option  if  you  have  already  used  the /e
  1180.                          option. Caution : If you  select  this  option and
  1181.                          you do not have  an  Everex  Edge or Hercules card
  1182.                          installed,  the  results are  unpredictable.  This
  1183.  
  1184.  
  1185.                                                                     Page 13
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.           Installing and Starting PC-VT                         PC-VT v10.0
  1193.  
  1194.  
  1195.                          mode  REQUIRES  the  IBM  monochrome   monitor  be
  1196.                          connected to the Edge card. 132 column mode is not
  1197.                          supported if you just  use  the  /h option and you
  1198.                          have the Everex  Edge  card  installed  -  in that
  1199.                          case, use the /e option.
  1200.  
  1201.           /i             tells PC-VT that you want to use what ever monitor
  1202.                          is attached to your system.  This  is  the default
  1203.                          and needs only be entered if you want  to  reset a
  1204.                          /h, /b, or /e option specified previously.
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.           Page 14
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.                                       Chapter 4
  1268.  
  1269.                                    Stopping PC-VT
  1270.  
  1271.  
  1272.                   Since CTRL-C is a  valid  key for the VT100 and the 4014,
  1273.           PC-VT intercepts both that key  and CTRL-BREAK before DOS can use
  1274.           them  to  terminate  the program.  Even in the non communications
  1275.           frames, PC-VT cannot be  terminated  by  pressing CTRL-C or CTRL-
  1276.           BREAK.
  1277.  
  1278.                   Therefore,  to  terminate  PC-VT,  press CTRL-F8 from the
  1279.           communications frame.
  1280.  
  1281.                   The screen clears, control returns  to  DOS  and  the DOS
  1282.           prompt  appears.  The  host connection is not broken (DTR and RTS
  1283.           are   kept   active)   and   restarting    PC-VT   re-establishes
  1284.           communications.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                                                     Page 15
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.           Stopping PC-VT                                        PC-VT v10.0
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.           Page 16
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.                                       Chapter 5
  1400.  
  1401.                              VT100 Keyboard Assignments
  1402.  
  1403.  
  1404.                   Since the keyboard on the IBM  PC  is not the same as the
  1405.           VT100, certain keys have to be mapped. The basic keyboard  is the
  1406.           same of course. The keypad, cursor keys and certain other control
  1407.           keys are in different positions on the two  keyboards.  The other
  1408.           major difference is the lack of separate cursor keys  on  the  PC
  1409.           (the cursor keys and the keypad occupy the same  keys).  You  can
  1410.           also  make a custom keyboard mapping  described  in  the  section
  1411.           titled Keyboard Redefinition.
  1412.  
  1413.  
  1414.           5.1  Regular Key Mapping
  1415.  
  1416.  
  1417.  
  1418.           VT100           PC              Notes Key
  1419.                           Equivalent
  1420.                           Key
  1421.  
  1422.  
  1423.           DELETE
  1424.  
  1425.                          Backspace   The  backspace  key  on  the   IBM  PC
  1426.                          keyboard emulates the DELETE key on the  VT100. An
  1427.                          option on the SETUP  B  frame  lets you change the
  1428.                          IBM PC backspace key  to  send  an  ASCII 8 to the
  1429.                          host  instead  of  the  ASCII  127  per  the VT100
  1430.                          definition.
  1431.  
  1432.                          Del         When the keyboard is in numeric keypad
  1433.                          mode, the Del key sends  a  DEL  character  to the
  1434.                          host (ASCII 127).  In application keypad mode, the
  1435.                          keypad is redefined  to  work with one of the text
  1436.                          editors: EDT, EVE or VI.
  1437.  
  1438.  
  1439.  
  1440.           BACKSPACE
  1441.  
  1442.                          Shift-Tab   The  SHIFT-Tab  key  sends a backspace
  1443.                          character (ASCII 8) to the host.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                                                     Page 17
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.           VT100 Keyboard Assignments                            PC-VT v10.0
  1457.  
  1458.  
  1459.                          Backspace   Alternate  method.  Use  the  SETUP  B
  1460.                          frame to change the IBM PC backspace key to send a
  1461.                          backspace (ASCII 8) to the host.
  1462.  
  1463.                          CTRL-H      The   CTRL-H   key  always   sends   a
  1464.                          backspace character (ASCII 8).
  1465.  
  1466.  
  1467.  
  1468.           LINEFEED
  1469.  
  1470.                          CTRL-J      This key combination sends a line feed
  1471.                          character to the host.
  1472.  
  1473.  
  1474.  
  1475.           CTRL-@
  1476.  
  1477.                          CTRL-@      This  key  combination  sends  a   NUL
  1478.                          character (ASCII  0) to the host. This is the same
  1479.                          as the VT100.
  1480.  
  1481.  
  1482.  
  1483.           NO SCROLL
  1484.  
  1485.                          SCROLL LOCK The SCROLL LOCK  key on IBM PC freezes
  1486.                          the display  and emulates the NO SCROLL key on the
  1487.                          VT100. PC-VT displays the word "SCR" on the status
  1488.                          line of  the display to remind you that the SCROLL
  1489.                          LOCK key has been depressed once.
  1490.  
  1491.                                      Depressing the key again resets SCROLL
  1492.                          LOCK and clears the  status  line  reminder. PC-VT
  1493.                          continues to accept characters from the host until
  1494.                          PC-VT's communications buffer fills at which point
  1495.                          PC-VT sends an XOFF.
  1496.  
  1497.                                      Pressing the Keypad + (plus) key dumps
  1498.                          the   screen   onto   a   disk  file.  The  screen
  1499.                          information is appended to the file if  it already
  1500.                          exists.  The  file is named  SCRNDUMP.DAT  and  is
  1501.                          created on the  default drive. Trailing spaces are
  1502.                          removed from  each  screen  line  as  the  data is
  1503.                          written to disk.
  1504.  
  1505.                                      The  Scroll  Buffer  section  in  this
  1506.                          chapter, describes PC-VT  features  activated when
  1507.                          you press the SCROLL LOCK key.
  1508.  
  1509.  
  1510.  
  1511.           ARROWS
  1512.  
  1513.  
  1514.  
  1515.           Page 18
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1523.  
  1524.  
  1525.                          Cursor Keys The  four  cursor  keys  on the IBM PC
  1526.                          keyboard emulate  the  four  cursor  keys  on  the
  1527.                          VT100.  NUM LOCK must be off  for  these  keys  to
  1528.                          function. If NUM LOCK is set, the keypad generates
  1529.                          the numeric characters shown on the keys.
  1530.  
  1531.  
  1532.  
  1533.           HERE IS
  1534.  
  1535.                          ALT-B       The ALT-B key emulates the HERE IS key
  1536.                          on the VT.  That  is,  the  answerback  message is
  1537.                          transmitted.
  1538.  
  1539.  
  1540.  
  1541.           ----
  1542.  
  1543.                          NUM LOCK    The  NUM  LOCK  key  places the IBM PC
  1544.                          keypad in numeric mode. The NUM LOCK key functions
  1545.                          locally in the  PC  only and does not transmit any
  1546.                          characters  to  the  host computer. PC-VT displays
  1547.                          the word "NUM"  on  the status line of the display
  1548.                          to  remind  you  that the NUM LOCK  key  has  been
  1549.                          depressed  once.  Depressing  the key again resets
  1550.                          NUM LOCK and clears the reminder.
  1551.  
  1552.  
  1553.  
  1554.           ----
  1555.  
  1556.                          CAPS LOCK   The CAPS LOCK key  places  the  IBM PC
  1557.                          keyboard  in  uppercase mode. The  CAPS  LOCK  key
  1558.                          functions locally in  the  PC  only  and  does not
  1559.                          transmit any characters  to the host computer. PC-
  1560.                          VT displays the  word  "CAP" on the status line of
  1561.                          the display to  remind  you that the CAPS LOCK key
  1562.                          has been depressed  once. Depressing the key again
  1563.                          resets CAPS LOCK and clears the reminder.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                                                     Page 19
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.           VT100 Keyboard Assignments                            PC-VT v10.0
  1589.  
  1590.  
  1591.  
  1592.  
  1593.           5.2  Keypad Mapping
  1594.  
  1595.  
  1596.                   In VT100 Numeric Keypad mode, F1 thru F4 on  the  IBM  PC
  1597.           keyboard emulate the PF1 thru PF4 keys on the VT100.
  1598.  
  1599.                   In VT100 Application Keypad  mode,  F1  thru F10 map onto
  1600.           the  VT100 keypad as follows (PC-VT  displays  the  Greek  letter
  1601.           alpha on the status line to indicate that Application Keypad mode
  1602.           is set. This mode is set and reset  only  by  an  escape sequence
  1603.           from the host computer.):
  1604.  
  1605.                IBM PC Key ..... VT100 Key
  1606.  
  1607.                F1 ................... PF1
  1608.                F2 ................... PF2
  1609.                F3 ..................... 7
  1610.                F4 ..................... 8
  1611.                F5 ..................... 4
  1612.                F6 ..................... 5
  1613.                F7 ..................... 1
  1614.                F8 ..................... 2
  1615.                F9 ..................... 0
  1616.                F10 .................... 0
  1617.  
  1618.                SHIFT-F1 ............. PF3
  1619.                SHIFT-F2 ............. PF4
  1620.                SHIFT-F3 ............... 9
  1621.                SHIFT-F4 ............... -
  1622.                SHIFT-F5 ............... 6
  1623.                SHIFT-F6 ............... ,
  1624.                SHIFT-F7 ............... 3
  1625.                SHIFT-F8 ........... ENTER
  1626.                SHIFT-F9 ............... .
  1627.                SHIFT-F10 .......... ENTER
  1628.  
  1629.                   This  assignment was closely follows the physical  layout
  1630.           of the keypad on the VT100. The VT100 has four columns of keys in
  1631.           the keypad. PC-VT emulates the two left columns with the function
  1632.           keys and emulates the two right columns with the shifted function
  1633.           keys.  Users  who  are  familiar  with the VT100 keypad and  have
  1634.           memorized the position of each  key  should  have  little trouble
  1635.           using this function key mapping. Note that the "0"  key  and  the
  1636.           ENTER  key are mapped onto two of the PC keys. This is because on
  1637.           the VT100, the "0" and ENTER keys are double width.
  1638.  
  1639.                   Note : NUM LOCK is handled locally in the IBM PC. For the
  1640.           keypad keys to work correctly when using PC-VT,  NUM  LOCK should
  1641.           not be set.
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.           Page 20
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1655.  
  1656.  
  1657.                   Figure 1 shows this  mapping.  The name of the IBM PC key
  1658.           is in the upper left of each key and the emulated key or function
  1659.           is shown in the center of the key.
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                                                                     Page 21
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.           VT100 Keyboard Assignments                            PC-VT v10.0
  1721.  
  1722.  
  1723.                           Figure 1 KEYPAD FUNCTION MAPPING
  1724.  
  1725.  
  1726.               FUNCTION KEYS                   SHIFTED FUNCTION KEYS
  1727.  
  1728.  
  1729.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1730.               │F1        │ │F2        │ │F1        │ │F2        │
  1731.               │          │ │          │ │          │ │          │
  1732.               │   PF1    │ │   PF2    │ │   PF3    │ │   PF4    │
  1733.               │          │ │          │ │          │ │          │
  1734.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  1735.  
  1736.  
  1737.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1738.               │F3        │ │F4        │ │F3        │ │F4        │
  1739.               │          │ │          │ │          │ │          │
  1740.               │    7     │ │     8    │ │     9    │ │     -    │
  1741.               │          │ │          │ │          │ │          │
  1742.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  1743.  
  1744.  
  1745.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1746.               │F5        │ │F6        │ │F5        │ │F6        │
  1747.               │          │ │          │ │          │ │          │
  1748.               │    4     │ │     5    │ │     6    │ │     ,    │
  1749.               │          │ │          │ │          │ │          │
  1750.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  1751.  
  1752.  
  1753.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1754.               │F7        │ │F8        │ │F7        │ │F8        │
  1755.               │          │ │          │ │          │ │          │
  1756.               │    1     │ │     2    │ │     3    │ │          │
  1757.               │          │ │          │ │          │ │          │
  1758.               └──────────┘ └──────────┘ └──────────┘ │          │
  1759.                                                      │          │
  1760.                                                      │  ENTER   │
  1761.               ┌───────────────────────┐ ┌──────────┐ │          │
  1762.               │F9           F10       │ │F9        │ │F10       │
  1763.               │                       │ │          │ │          │
  1764.               │         0             │ │     .    │ │          │
  1765.               │                       │ │          │ │          │
  1766.               └───────────────────────┘ └──────────┘ └──────────┘
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.           Page 22
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1787.  
  1788.  
  1789.  
  1790.  
  1791.           5.3  VMS Line Editing Keypad Mapping
  1792.  
  1793.  
  1794.                   In VT100 Numeric Keypad mode, which is the normal mode of
  1795.           operation, PC-VT supports the VMS line editing commands using the
  1796.           PC's Keypad. This mapping  is  in  effect  only in Numeric Keypad
  1797.           mode; in  Application Keypad mode, the selected text editor, EVE,
  1798.           EDT or VI, takes over the PC's keypad.
  1799.  
  1800.                IBM PC Key ............ Line Editing Function Performed
  1801.  
  1802.                Keypad + ................ Enter key on the VT100 Keypad
  1803.                Del key .................. Deletes the character to the
  1804.                                                     left of the cursor
  1805.                Up Arrow .................. Recall the previous command
  1806.                Down Arrow .................... Recall the next command
  1807.                Left Arrow ....................... Move the cursor left
  1808.                Right Arrow ..................... Move the cursor right
  1809.                Ins key  ............... Toggles Insert/Overstrike mode
  1810.                Home key ................ Moves the cursor to the start
  1811.                                                            of the line
  1812.                End key  .................. Moves the cursor to the end
  1813.                                                               the line
  1814.                PgUp key .................. Deletes characters from the
  1815.                                    beginning of the line to the cursor
  1816.                PgDn key ...................... Deletes the word at the
  1817.                                                                 cursor
  1818.  
  1819.                   Figure 2 shows this  mapping.  The name of the IBM PC key
  1820.           is in the upper left of each key and the emulated key or function
  1821.           is then shown in the center of the key.
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.                                                                     Page 23
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.           VT100 Keyboard Assignments                            PC-VT v10.0
  1853.  
  1854.  
  1855.                     Figure 2 PC-VT SPECIAL VMS LINE EDIT MAPPING
  1856.  
  1857.  
  1858.                      PC KEYPAD KEYS as MAPPED into VMS Line Editing
  1859.  
  1860.           ══════════════════════════════════════════════════════════════
  1861.  
  1862.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1863.                      │7         │ │8         │ │9         │ │-[minus]  │
  1864.                      │CURSOR TO │ │ RECALL   │ │ DELETE   │ │          │
  1865.                      │  START   │ │ PREVIOUS │ │ BOL TO   │ │          │
  1866.                      │ OF LINE  │ │ COMMAND  │ │ CURSOR   │ │          │
  1867.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  1868.  
  1869.  
  1870.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1871.                      │4         │ │5         │ │6         │ │+[plus]   │
  1872.                      │          │ │          │ │          │ │          │
  1873.                      │  CURSOR  │ │          │ │  CURSOR  │ │          │
  1874.                      │   LEFT   │ │          │ │   RIGHT  │ │          │
  1875.                      └──────────┘ └──────────┘ └──────────┘ │          │
  1876.                                                             │          │
  1877.                                                             │          │
  1878.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  1879.                      │1         │ │2         │ │3         │ │          │
  1880.                      │ CURSOR   │ │ RECALL   │ │ DELETE   │ │  ENTER   │
  1881.                      │ TO END   │ │ NEXT     │ │ WORD     │ │          │
  1882.                      │ OF LINE  │ │ COMMAND  │ │          │ │          │
  1883.                      └──────────┘ └──────────┘ └──────────┘ │          │
  1884.                                                             │          │
  1885.                                                             │          │
  1886.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  1887.           │0                    │ │.[period]              │ │          │
  1888.           │   TOGGLE            │ │      DELETE           │ │          │
  1889.           │   INSERT/OVERSTRIKE │ │      CHARACTER        │ │          │
  1890.           │                     │ │                       │ │          │
  1891.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.           Page 24
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.           PC-VT v10.0                                 VT100 & 4014 Emulator
  1919.  
  1920.  
  1921.  
  1922.  
  1923.           5.4  EDT Keypad Mapping
  1924.  
  1925.  
  1926.                   In VT100 Application Keypad mode, which is set by the VMS
  1927.           EDT  text  editor,  the  following  keys  cause   special  escape
  1928.           sequences to be  transmitted.  Observe that some of these special
  1929.           keys transmit sequences that  require  two  or more keystrokes on
  1930.           the  VT100.  PC-VT  displays the Greek letter alpha on the status
  1931.           line to indicate that this mode is active.
  1932.  
  1933.                   Bits  in  the  SETUP frame select either VMS or UNIX mode
  1934.           and  select  EDT  or EVE keypad support for this special mapping.
  1935.           For  this  mapping,  VMS  mode  and EDT keypad support should  be
  1936.           selected.
  1937.  
  1938.                IBM PC Key ..................... EDT Function Performed
  1939.  
  1940.                Keypad + ................ Enter key on the VT100 Keypad
  1941.                Keypad - .. DEL L (delete line) key on the VT100 Keypad
  1942.                Del key ...................... DEL C (delete character)
  1943.                Backspace ................ Deletes the character to the
  1944.                or                      left of the cursor (DELETE key
  1945.                ALT-=                                     on the VT100)
  1946.                Ins key  .................................... OPEN LINE
  1947.                Home key .......................................... TOP
  1948.                End key  ....................................... BOTTOM
  1949.                PgUp key .................................. BACKUP SECT
  1950.                PgDn key ................................. ADVANCE SECT
  1951.                CTRL-Home key ............ Deletes the word to the left
  1952.                or                          of the cursor (LINEFEED key
  1953.                CTRL-J                                    on the VT100)
  1954.                CTRL-End key ............ ADVANCE DEL EOL - Erases from
  1955.                                                  the cursor to the end
  1956.                                                           of the line.
  1957.                CTRL-PgUp key ............................. BACKUP PAGE
  1958.                CTRL-PgDn key ............................ ADVANCE PAGE
  1959.                CTRL-Left Arrow key ....... BACKUP EOL - Move cursor to
  1960.                                                         the end of the
  1961.                                                         previous line.
  1962.                CTRL-Right Arrow key .... ADVANCE EOL - Move the cursor
  1963.                                                      to the end of the
  1964.                                                          current line.
  1965.                SHIFT-Tab ......................... Moves the cursor to
  1966.                                              the beginning of the line
  1967.                                          (BACKSPACE key on the VT100).
  1968.  
  1969.                   Figure 3 shows this  mapping.  The name of the IBM PC key
  1970.           is in the upper left of each key and the emulated key or function
  1971.           is then shown in the center of the key.
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.                                                                     Page 25
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.           VT100 Keyboard Assignments                            PC-VT v10.0
  1985.  
  1986.  
  1987.                        Figure 3 VT100 SPECIAL EDT KEY MAPPING
  1988.  
  1989.  
  1990.               FUNCTION KEYS                   SHIFTED FUNCTION KEYS
  1991.  
  1992.               For Functions in (), press GOLD Key First.
  1993.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  1994.               │F1        │ │F2        │ │F1        │ │F2        │
  1995.               │          │ │          │ │          │ │          │
  1996.               │  GOLD    │ │  HELP    │ │  FNDNXT  │ │   DEL L  │
  1997.               │          │ │          │ │  (FIND)  │ │  (UND L) │
  1998.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  1999.  
  2000.  
  2001.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2002.               │F3        │ │F4        │ │F3        │ │F4        │
  2003.               │          │ │          │ │          │ │          │
  2004.               │  PAGE    │ │  SECT    │ │ APPEND   │ │   DEL W  │
  2005.               │(COMMAND) │ │ (FILL)   │ │(REPLACE) │ │  (UND W) │
  2006.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2007.  
  2008.  
  2009.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2010.               │F5        │ │F6        │ │F5        │ │F6        │
  2011.               │          │ │          │ │          │ │          │
  2012.               │ ADVANCE  │ │ BACKUP   │ │   CUT    │ │   DEL C  │
  2013.               │ (BOTTOM) │ │  (TOP)   │ │ (PASTE)  │ │  (UND C) │
  2014.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2015.  
  2016.  
  2017.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2018.               │F7        │ │F8        │ │F7        │ │F8        │
  2019.               │          │ │          │ │          │ │          │
  2020.               │  WORD    │ │   EOL    │ │  CHAR    │ │          │
  2021.               │(CHNG C)  │ │ (DEL EOL)│ │(SPECINS) │ │          │
  2022.               └──────────┘ └──────────┘ └──────────┘ │  ENTER   │
  2023.                                                      │  (SUBS)  │
  2024.                                                      │          │
  2025.               ┌───────────────────────┐ ┌──────────┐ │          │
  2026.               │F9           F10       │ │F9        │ │F10       │
  2027.               │                       │ │          │ │          │
  2028.               │     LINE              │ │  SELECT  │ │          │
  2029.               │        (OPEN LINE)    │ │  (RESET) │ │          │
  2030.               └───────────────────────┘ └──────────┘ └──────────┘
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.           Page 26
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2051.  
  2052.  
  2053.                       VT100 SPECIAL EDT KEY MAPPING..continued
  2054.  
  2055.  
  2056.                      PC KEYPAD KEYS as MAPPED into EDT
  2057.  
  2058.           For Functions in (), press GOLD Key First.
  2059.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2060.                      │7         │ │8         │ │9         │ │-[minus]  │
  2061.                      │          │ │          │ │          │ │          │
  2062.                      │  TOP     │ │  CURSOR  │ │  BACKUP  │ │  DEL L   │
  2063.                      │          │ │    UP    │ │   SECT   │ │          │
  2064.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2065.  
  2066.  
  2067.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2068.                      │4         │ │5         │ │6         │ │+[plus]   │
  2069.                      │          │ │          │ │          │ │          │
  2070.                      │  CURSOR  │ │          │ │  CURSOR  │ │          │
  2071.                      │   LEFT   │ │          │ │   RIGHT  │ │          │
  2072.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2073.                                                             │          │
  2074.                                                             │          │
  2075.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2076.                      │1         │ │2         │ │3         │ │          │
  2077.                      │          │ │          │ │          │ │          │
  2078.                      │  BOTTOM  │ │  CURSOR  │ │ ADVANCE  │ │  ENTER   │
  2079.                      │          │ │   DOWN   │ │  SECT    │ │          │
  2080.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2081.                                                             │          │
  2082.                                                             │          │
  2083.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2084.           │0                    │ │.[period]              │ │          │
  2085.           │                     │ │                       │ │          │
  2086.           │   OPEN LINE         │ │         DEL C         │ │          │
  2087.           │     (LINE)          │ │        (UND C)        │ │          │
  2088.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                                                                     Page 27
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.           VT100 Keyboard Assignments                            PC-VT v10.0
  2117.  
  2118.  
  2119.                       VT100 SPECIAL EDT KEY MAPPING..continued
  2120.  
  2121.  
  2122.               PC KEYPAD KEYS as MAPPED into EDT - HOLD DOWN CTRL KEY
  2123.  
  2124.  
  2125.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2126.                      │7         │ │8         │ │9         │ │-[minus]  │
  2127.                      │ DELETE TO│ │          │ │  BACKUP  │ │          │
  2128.                      │ START OF │ │          │ │   PAGE   │ │          │
  2129.                      │ WORD     │ │          │ │          │ │          │
  2130.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2131.  
  2132.  
  2133.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2134.                      │4         │ │5         │ │6         │ │+[plus]   │
  2135.                      │ CURSOR TO│ │          │ │ CURSOR TO│ │          │
  2136.                      │ END OF   │ │          │ │ END OF   │ │          │
  2137.                      │ LAST LINE│ │          │ │ LINE     │ │          │
  2138.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2139.                                                             │          │
  2140.                                                             │          │
  2141.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2142.                      │1         │ │2         │ │3         │ │          │
  2143.                      │ ERASE TO │ │          │ │ ADVANCE  │ │          │
  2144.                      │ END OF   │ │          │ │  PAGE    │ │          │
  2145.                      │ LINE     │ │          │ │          │ │          │
  2146.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2147.                                                             │          │
  2148.                                                             │          │
  2149.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2150.           │0                    │ │.[period]              │ │          │
  2151.           │                     │ │                       │ │          │
  2152.           │                     │ │                       │ │          │
  2153.           │                     │ │                       │ │          │
  2154.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.           Page 28
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2183.  
  2184.  
  2185.               Figure 4 VT52 COMPATIBILITY MODE SPECIAL EDT KEY MAPPING
  2186.  
  2187.  
  2188.               FUNCTION KEYS                   SHIFTED FUNCTION KEYS
  2189.  
  2190.               For Functions in (), press GOLD Key First.
  2191.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2192.               │F1        │ │F2        │ │F1        │ │F2        │
  2193.               │          │ │          │ │          │ │          │
  2194.               │  GOLD    │ │  HELP    │ │   DEL L  │ │  NOT     │
  2195.               │          │ │          │ │  (UND L) │ │  USED    │
  2196.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2197.  
  2198.  
  2199.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2200.               │F3        │ │F4        │ │F3        │ │F4        │
  2201.               │          │ │          │ │          │ │          │
  2202.               │  PAGE    │ │  FNDNXT  │ │   DEL W  │ │  NOT     │
  2203.               │(COMMAND) │ │  (FIND)  │ │  (UND W) │ │  USED    │
  2204.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2205.  
  2206.  
  2207.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2208.               │F5        │ │F6        │ │F5        │ │F6        │
  2209.               │          │ │          │ │          │ │          │
  2210.               │ ADVANCE  │ │ BACKUP   │ │   DEL C  │ │  NOT     │
  2211.               │ (BOTTOM) │ │  (TOP)   │ │  (UND C) │ │  USED    │
  2212.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2213.  
  2214.  
  2215.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2216.               │F7        │ │F8        │ │F7        │ │F8        │
  2217.               │          │ │          │ │          │ │          │
  2218.               │  WORD    │ │   EOL    │ │  CUT     │ │          │
  2219.               │(CHNG C)  │ │ (DEL EOL)│ │ (PASTE)  │ │          │
  2220.               └──────────┘ └──────────┘ └──────────┘ │  ENTER   │
  2221.                                                      │  (SUBS)  │
  2222.                                                      │          │
  2223.               ┌───────────────────────┐ ┌──────────┐ │          │
  2224.               │F9           F10       │ │F9        │ │F10       │
  2225.               │                       │ │          │ │          │
  2226.               │      LINE             │ │  SELECT  │ │          │
  2227.               │        (OPEN LINE)    │ │  (RESET) │ │          │
  2228.               └───────────────────────┘ └──────────┘ └──────────┘
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.                                                                     Page 29
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.           VT100 Keyboard Assignments                            PC-VT v10.0
  2249.  
  2250.  
  2251.              VT52 COMPATIBILITY MODE SPECIAL EDT KEY MAPPING..continued
  2252.  
  2253.  
  2254.                      PC KEYPAD KEYS as MAPPED into EDT
  2255.  
  2256.           For Functions in (), press GOLD Key First.
  2257.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2258.                      │7         │ │8         │ │9         │ │-[minus]  │
  2259.                      │          │ │  CURSOR  │ │          │ │          │
  2260.                      │  TOP     │ │    UP    │ │  BACKUP  │ │  DEL L   │
  2261.                      │          │ │(REPLACE) │ │   SECT   │ │          │
  2262.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2263.  
  2264.  
  2265.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2266.                      │4         │ │5         │ │6         │ │+[plus]   │
  2267.                      │  CURSOR  │ │          │ │  CURSOR  │ │          │
  2268.                      │   LEFT   │ │          │ │   RIGHT  │ │          │
  2269.                      │ (APPEND) │ │          │ │ (SPECINS)│ │          │
  2270.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2271.                                                             │          │
  2272.                                                             │          │
  2273.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2274.                      │1         │ │2         │ │3         │ │          │
  2275.                      │          │ │  CURSOR  │ │          │ │          │
  2276.                      │  BOTTOM  │ │   DOWN   │ │ ADVANCE  │ │  ENTER   │
  2277.                      │          │ │  (SECT)  │ │  SECT    │ │          │
  2278.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2279.                                                             │          │
  2280.                                                             │          │
  2281.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2282.           │0                    │ │.[period]              │ │          │
  2283.           │                     │ │                       │ │          │
  2284.           │   OPEN LINE         │ │         DEL C         │ │          │
  2285.           │     (LINE)          │ │        (UND C)        │ │          │
  2286.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.           Page 30
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2315.  
  2316.  
  2317.              VT52 COMPATIBILITY MODE SPECIAL EDT KEY MAPPING..continued
  2318.  
  2319.  
  2320.               PC KEYPAD KEYS as MAPPED into EDT - HOLD DOWN CTRL KEY
  2321.  
  2322.  
  2323.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2324.                      │7         │ │8         │ │9         │ │-[minus]  │
  2325.                      │ DELETE TO│ │          │ │  BACKUP  │ │          │
  2326.                      │ START OF │ │          │ │   PAGE   │ │          │
  2327.                      │ WORD     │ │          │ │          │ │          │
  2328.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2329.  
  2330.  
  2331.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2332.                      │4         │ │5         │ │6         │ │+[plus]   │
  2333.                      │ CURSOR TO│ │          │ │ CURSOR TO│ │          │
  2334.                      │ END OF   │ │          │ │ END OF   │ │          │
  2335.                      │ LAST LINE│ │          │ │ LINE     │ │          │
  2336.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2337.                                                             │          │
  2338.                                                             │          │
  2339.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2340.                      │1         │ │2         │ │3         │ │          │
  2341.                      │ ERASE TO │ │          │ │ ADVANCE  │ │          │
  2342.                      │ END OF   │ │          │ │  PAGE    │ │          │
  2343.                      │ LINE     │ │          │ │          │ │          │
  2344.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2345.                                                             │          │
  2346.                                                             │          │
  2347.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2348.           │0                    │ │.[period]              │ │          │
  2349.           │                     │ │                       │ │          │
  2350.           │                     │ │                       │ │          │
  2351.           │                     │ │                       │ │          │
  2352.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                                                     Page 31
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.           VT100 Keyboard Assignments                            PC-VT v10.0
  2381.  
  2382.  
  2383.  
  2384.  
  2385.           5.5  EVE Keypad Mapping
  2386.  
  2387.  
  2388.                   In VT100 Application Keypad mode, which is set by the VMS
  2389.           EVE  text  editor,  the  following  keys  cause   special  escape
  2390.           sequences to be  transmitted.  PC-VT  displays  the  Greek letter
  2391.           alpha on the status line to indicate that this mode is active.
  2392.  
  2393.                   Bits  in  the  SETUP frame select either VMS or UNIX mode
  2394.           and  select  EVE  or EVE keypad support for this special mapping.
  2395.           For  this  mapping,  VMS  mode  and EVE keypad support should  be
  2396.           selected.
  2397.  
  2398.                IBM PC Key ..................... EVE Function Performed
  2399.  
  2400.                Keypad + ........................................... Do
  2401.                Keypad - .......................... Moves the cursor to
  2402.                                              the beginning of the line
  2403.                Del key ........................................ Remove
  2404.                Backspace ................ Deletes the character to the
  2405.                or                      left of the cursor (DELETE key
  2406.                ALT-=                                     on the VT100)
  2407.                Ins key  .................................. Insert Here
  2408.                Home key ......................................... Find
  2409.                End key  ....................................... Select
  2410.                PgUp key .............................. Previous Screen
  2411.                PgDn key .................................. Next Screen
  2412.                CTRL-Home key .................................... Help
  2413.                CTRL-End key .......................... Forward/Reverse
  2414.                CTRL-PgUp key ...................................... Do
  2415.                CTRL-PgDn key .............................. Erase Word
  2416.                CTRL-Left Arrow key ................. Insert/Overstrike
  2417.                CTRL-Right Arrow key ..................... Move by Line
  2418.                SHIFT-Tab ......................... Moves the cursor to
  2419.                                              the beginning of the line
  2420.                                          (BACKSPACE key on the VT100).
  2421.  
  2422.                   Figure 5  shows this mapping. The name of the IBM  PC key
  2423.           is in the upper left of each key and the emulated key or function
  2424.           is then shown in the center of the key.
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.           Page 32
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2447.  
  2448.  
  2449.                        Figure 5 PC-VT SPECIAL EVE KEY MAPPING
  2450.  
  2451.  
  2452.               FUNCTION KEYS                   SHIFTED FUNCTION KEYS
  2453.  
  2454.  
  2455.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2456.               │F1        │ │F2        │ │F1        │ │F2        │
  2457.               │          │ │          │ │          │ │          │
  2458.               │  FIND    │ │  HELP    │ │ FORWARD/ │ │   DO     │
  2459.               │          │ │          │ │  REVERSE │ │          │
  2460.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2461.  
  2462.  
  2463.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2464.               │F3        │ │F4        │ │F3        │ │F4        │
  2465.               │          │ │          │ │          │ │          │
  2466.               │  SELECT  │ │  REMOVE  │ │ INSERT   │ │ MOVE BY  │
  2467.               │          │ │          │ │  HERE    │ │  LINE    │
  2468.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2469.  
  2470.  
  2471.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2472.               │F5        │ │F6        │ │F5        │ │F6        │
  2473.               │          │ │          │ │          │ │          │
  2474.               │ not used │ │  CURSOR  │ │ not used │ │  ERASE   │
  2475.               │          │ │    UP    │ │          │ │   WORD   │
  2476.               └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2477.  
  2478.  
  2479.               ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2480.               │F7        │ │F8        │ │F7        │ │F8        │
  2481.               │          │ │          │ │          │ │          │
  2482.               │  CURSOR  │ │  CURSOR  │ │  CURSOR  │ │          │
  2483.               │   LEFT   │ │   DOWN   │ │   RIGHT  │ │          │
  2484.               └──────────┘ └──────────┘ └──────────┘ │  INSERT/ │
  2485.                                                      │OVERSTRIKE│
  2486.                                                      │          │
  2487.               ┌───────────────────────┐ ┌──────────┐ │          │
  2488.               │F9           F10       │ │F9        │ │F10       │
  2489.               │                       │ │          │ │          │
  2490.               │     NEXT              │ │ PREVIOUS │ │          │
  2491.               │     SCREEN            │ │  SCREEN  │ │          │
  2492.               └───────────────────────┘ └──────────┘ └──────────┘
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.                                                                     Page 33
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.           VT100 Keyboard Assignments                            PC-VT v10.0
  2513.  
  2514.  
  2515.                       PC-VT SPECIAL EVE KEY MAPPING..continued
  2516.  
  2517.  
  2518.                      PC KEYPAD KEYS as MAPPED into EVE
  2519.  
  2520.  
  2521.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2522.                      │7         │ │8         │ │9         │ │-[minus]  │
  2523.                      │          │ │          │ │          │ │ CURSOR TO│
  2524.                      │  FIND    │ │  CURSOR  │ │ PREVIOUS │ │ START OF │
  2525.                      │          │ │    UP    │ │  SCREEN  │ │ LINE     │
  2526.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2527.  
  2528.  
  2529.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2530.                      │4         │ │5         │ │6         │ │+[plus]   │
  2531.                      │          │ │          │ │          │ │          │
  2532.                      │  CURSOR  │ │          │ │  CURSOR  │ │          │
  2533.                      │   LEFT   │ │          │ │   RIGHT  │ │          │
  2534.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2535.                                                             │          │
  2536.                                                             │          │
  2537.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2538.                      │1         │ │2         │ │3         │ │          │
  2539.                      │          │ │          │ │          │ │          │
  2540.                      │ SELECT   │ │  CURSOR  │ │   NEXT   │ │   DO     │
  2541.                      │          │ │   DOWN   │ │  SCREEN  │ │          │
  2542.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2543.                                                             │          │
  2544.                                                             │          │
  2545.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2546.           │0                    │ │.[period]              │ │          │
  2547.           │                     │ │                       │ │          │
  2548.           │   INSERT HERE       │ │      REMOVE           │ │          │
  2549.           │                     │ │                       │ │          │
  2550.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.           Page 34
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2579.  
  2580.  
  2581.                       PC-VT SPECIAL EVE KEY MAPPING..continued
  2582.  
  2583.  
  2584.               PC KEYPAD KEYS as MAPPED into EVE - HOLD DOWN CTRL KEY
  2585.  
  2586.  
  2587.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2588.                      │7         │ │8         │ │9         │ │-[minus]  │
  2589.                      │          │ │          │ │          │ │          │
  2590.                      │   HELP   │ │          │ │    DO    │ │          │
  2591.                      │          │ │          │ │          │ │          │
  2592.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2593.  
  2594.  
  2595.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2596.                      │4         │ │5         │ │6         │ │+[plus]   │
  2597.                      │          │ │          │ │          │ │          │
  2598.                      │ INSERT/  │ │          │ │ MOVE BY  │ │          │
  2599.                      │OVERSTRIKE│ │          │ │  LINE    │ │          │
  2600.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2601.                                                             │          │
  2602.                                                             │          │
  2603.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2604.                      │1         │ │2         │ │3         │ │          │
  2605.                      │          │ │          │ │          │ │          │
  2606.                      │ FORWARD/ │ │          │ │  ERASE   │ │          │
  2607.                      │ REVERSE  │ │          │ │   WORD   │ │          │
  2608.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2609.                                                             │          │
  2610.                                                             │          │
  2611.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2612.           │0                    │ │.[period]              │ │          │
  2613.           │                     │ │                       │ │          │
  2614.           │                     │ │                       │ │          │
  2615.           │                     │ │                       │ │          │
  2616.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.                                                                     Page 35
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.           VT100 Keyboard Assignments                            PC-VT v10.0
  2645.  
  2646.  
  2647.  
  2648.  
  2649.           5.6  VI Keypad Mapping
  2650.  
  2651.  
  2652.                   In VT100 Application Keypad mode,  which  is  set  by the
  2653.           UNIX  VI text editor, the following  keys  cause  special  escape
  2654.           sequences to  be transmitted. Some of these special keys transmit
  2655.           sequences that require two or more keystrokes on the VT100. PC-VT
  2656.           displays  the  Greek  letter alpha in the status line to indicate
  2657.           that this mode is active.
  2658.  
  2659.                   A bit in the SETUP frame selects either VMS or  UNIX mode
  2660.           for this special mapping. For this mapping, UNIX  mode  should be
  2661.           selected.
  2662.  
  2663.                IBM PC Key ...................... VI Function Performed
  2664.  
  2665.                Del key ............................ Delete a character
  2666.                ALT-= ......................... DELETE key on the VT100
  2667.                Ins key ........................... Go into Insert Mode
  2668.                Home key .................. Go to beginning of the file
  2669.                End key ......................... Go to end of the file
  2670.                PgUp key ........................... Scroll up the file
  2671.                PgDn key ......................... Scroll down the file
  2672.                CTRL-Home key ..................... Go to start of line
  2673.                CTRL-End key ........................ Go to end of line
  2674.                CTRL-PgUp key ................. Go to top of the screen
  2675.                CTRL-PgDn key .............. Go to bottom of the screen
  2676.                CTRL-Left Arrow key ............... Go to previous word
  2677.                CTRL-Right Arrow key .................. Go to next word
  2678.  
  2679.                   This VI keypad mapping  is  only  supported  in VT100/102
  2680.           mode not in VT52 compatibility mode.
  2681.  
  2682.                   Figure 6 shows this  mapping.  The name of the IBM PC key
  2683.           is in the upper left of each key and the emulated key or function
  2684.           is then shown in the center of the key.
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.           Page 36
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2711.  
  2712.  
  2713.                         Figure 6 VT100 SPECIAL VI KEY MAPPING
  2714.  
  2715.  
  2716.                       PC KEYPAD KEYS as MAPPED into VI
  2717.           ══════════════════════════════════════════════════════════════
  2718.  
  2719.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2720.                      │7         │ │8         │ │9         │ │-[minus]  │
  2721.                      │ GO TO    │ │  CURSOR  │ │  SCROLL  │ │          │
  2722.                      │ TOP      │ │    UP    │ │    UP    │ │          │
  2723.                      │ OF FILE  │ │          │ │          │ │          │
  2724.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2725.  
  2726.  
  2727.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2728.                      │4         │ │5         │ │6         │ │+[plus]   │
  2729.                      │ CURSOR   │ │          │ │ CURSOR   │ │          │
  2730.                      │ LEFT     │ │          │ │ RIGHT    │ │          │
  2731.                      │          │ │          │ │          │ │          │
  2732.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2733.                                                             │          │
  2734.                                                             │          │
  2735.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2736.                      │1         │ │2         │ │3         │ │          │
  2737.                      │ GO TO    │ │  CURSOR  │ │  SCROLL  │ │          │
  2738.                      │ END      │ │   DOWN   │ │   DOWN   │ │          │
  2739.                      │ OF FILE  │ │          │ │          │ │          │
  2740.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2741.                                                             │          │
  2742.                                                             │          │
  2743.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2744.           │0                    │ │.[period]              │ │          │
  2745.           │                     │ │                       │ │          │
  2746.           │   ENTER INSERT      │ │         DELETE        │ │          │
  2747.           │       MODE          │ │       A CHARACTER     │ │          │
  2748.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.                                                                     Page 37
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.           VT100 Keyboard Assignments                            PC-VT v10.0
  2777.  
  2778.  
  2779.                        VT100 SPECIAL VI KEY MAPPING..continued
  2780.  
  2781.  
  2782.               PC KEYPAD KEYS as MAPPED into VI - HOLD DOWN CTRL KEY
  2783.           ══════════════════════════════════════════════════════════════
  2784.  
  2785.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2786.                      │7         │ │8         │ │9         │ │-[minus]  │
  2787.                      │ GO TO    │ │          │ │  GO TO   │ │          │
  2788.                      │ START OF │ │          │ │  TOP OF  │ │          │
  2789.                      │ LINE     │ │          │ │  SCREEN  │ │          │
  2790.                      └──────────┘ └──────────┘ └──────────┘ └──────────┘
  2791.  
  2792.  
  2793.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
  2794.                      │4         │ │5         │ │6         │ │+[plus]   │
  2795.                      │ GO TO    │ │          │ │ GO TO    │ │          │
  2796.                      │ PREVIOUS │ │          │ │ NEXT     │ │          │
  2797.                      │ WORD     │ │          │ │ WORD     │ │          │
  2798.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2799.                                                             │          │
  2800.                                                             │          │
  2801.                      ┌──────────┐ ┌──────────┐ ┌──────────┐ │          │
  2802.                      │1         │ │2         │ │3         │ │          │
  2803.                      │ GO TO    │ │          │ │ GO TO    │ │          │
  2804.                      │ END OF   │ │          │ │ BOTTOM OF│ │          │
  2805.                      │ LINE     │ │          │ │ SCREEN   │ │          │
  2806.                      └──────────┘ └──────────┘ └──────────┘ │          │
  2807.                                                             │          │
  2808.                                                             │          │
  2809.           ┌─────────────────────┐ ┌───────────────────────┐ │          │
  2810.           │0                    │ │.[period]              │ │          │
  2811.           │                     │ │                       │ │          │
  2812.           │                     │ │                       │ │          │
  2813.           │                     │ │                       │ │          │
  2814.           └─────────────────────┘ └───────────────────────┘ └──────────┘
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.           Page 38
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2843.  
  2844.  
  2845.  
  2846.  
  2847.           5.7  Control Function Keys
  2848.  
  2849.  
  2850.            CTRL-F1:      PC-VT enters the SETUP frame. See Chapter 6.
  2851.  
  2852.           CTRL-F2:       Lets   you   change   the  default  directory  for
  2853.                          uploading and downloading files. See Chapter 8.
  2854.  
  2855.           CTRL-F3:       Receives a file (ASCII,  XMODEM,  or  KERMIT). See
  2856.                          Chapter 8.
  2857.  
  2858.           CTRL-F4:       Transmits  a file (ASCII, XMODEM, or KERMIT).  See
  2859.                          Chapter 8.
  2860.  
  2861.           CTRL-F5:       Prints  screen.  The  screen  is  printed  on  the
  2862.                          selected  printer (LPT1 or LPT2), if present.  The
  2863.                          printer is selected in the SETUP B frame.
  2864.  
  2865.                          Performs the  same function as receipt of a "ESC [
  2866.                          i" sequence. If the Print Termination Character is
  2867.                          set  in  the  SETUP  B  frame,  the  printer paper
  2868.                          advances to the top of  the  next  page  after the
  2869.                          screen is printed.
  2870.  
  2871.           CTRL-F6:       Echoes to selected printer (LPT1 or LPT2). Toggles
  2872.                          On/Off   echoing  to  the  selected  printer,   if
  2873.                          present. The printer is selected  in  the  SETUP B
  2874.                          frame.   Prints   all   characters   received   or
  2875.                          transmitted to/from the host. Characters displayed
  2876.                          on the status line (line 25) are never printed.
  2877.  
  2878.                          Performs the  same function as receipt of "ESC [ ?
  2879.                          5  i"  and  "ESC  [  ?  4  i"  sequences. A 'P' is
  2880.                          displayed in  column  42  of  the  status  line to
  2881.                          remind you that printer  echo  is  on.  A Formfeed
  2882.                          which is normally translated to a linefeed  by PC-
  2883.                          VT is  retained as a formfeed when printer echo is
  2884.                          on.
  2885.  
  2886.           CTRL-F7:       Sends a break to  the  host.  Confirmation  of the
  2887.                          operation is a click at the start of the break and
  2888.                          another click  at the end of the operation. If the
  2889.                          disconnect  character  feature  is selected in the
  2890.                          SETUP B frame, PC-VT sends an EOT character (ASCII
  2891.                          4) before it sends the break. A BREAK is a "space"
  2892.                          condition   on   the  line  for   at   least   275
  2893.                          milliseconds. To send  a long BREAK or disconnect,
  2894.                          press ALT-Q.
  2895.  
  2896.           CTRL-F8 or ALT-C :
  2897.                          Terminates PC-VT and returns to DOS.  Use  the ALT
  2898.                          key for PCjr's.
  2899.  
  2900.  
  2901.                                                                     Page 39
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.           VT100 Keyboard Assignments                            PC-VT v10.0
  2909.  
  2910.  
  2911.           CTRL-F9 or ALT-V :
  2912.                          Enters  the  DIALING  frame.  See  Chapter  9  for
  2913.                          instructions. The ALT key is for PCjr users.
  2914.  
  2915.           CTRL-F10 or ALT-O :
  2916.                          Enters  the  MACRO   frame.  See  Chapter  10  for
  2917.                          instructions. The ALT key is for PCjr users.
  2918.  
  2919.  
  2920.           5.8  ALT Keys
  2921.  
  2922.  
  2923.           ALT-F1 thru ALT-F10 :
  2924.                          Can be used as macro keys.
  2925.  
  2926.           ALT-B:         Emulates the HERE IS  key  on  the VT. PC-VT sends
  2927.                          the answerback message which is set in the SETUP B
  2928.                          frame.
  2929.  
  2930.           ALT-H:         Enters the HELP frame.  Once  you  are in the HELP
  2931.                          frame, use the PgDn key to look at  the  next HELP
  2932.                          page. Use the PgUp key  to  look  at  the previous
  2933.                          HELP page and use  the  Esc  key  to exit HELP and
  2934.                          return to  the  emulator.  HELP  works  from  most
  2935.                          frames  and is context sensitive. For example,  if
  2936.                          you need HELP within  the  SETUP  frames,  you get
  2937.                          SETUP information.
  2938.  
  2939.           ALT-K :        Starts  up  the KERMIT module.  See  the  attached
  2940.                          KERMIT document for details on its command set.
  2941.  
  2942.           ALT-F :        Starts  up  another  copy  of COMMAND.COM. This is
  2943.                          done without  terminating  PC-VT  or  breaking the
  2944.                          host  connection.   Once the  new  COMMAND.COM  is
  2945.                          started, you  can run any DOS function or other PC
  2946.                          program.  CAUTION : You should be careful that you
  2947.                          don't   run   a  program  that   uses   the   same
  2948.                          communications port as PC-VT is using.   The other
  2949.                          program may leave the port in an unexpected state.
  2950.                          PC-VT may not then be able to get  control  of the
  2951.                          port again.   Also be careful that you don't alter
  2952.                          any files which  PC-VT  may be using. To exit from
  2953.                          the new copy of COMMAND.COM and  return  to PC-VT,
  2954.                          type "exit" at the command prompt.
  2955.  
  2956.           ALT-Q :        Long BREAK or Disconnect. Causes PC-VT to drop the
  2957.                          RTS   and   DTR   lines   for   one-half   second.
  2958.                          Confirmation of the operation is  a  click  at the
  2959.                          start of the long BREAK along  with  another click
  2960.                          at the end of  the  operation.  If  the disconnect
  2961.                          character feature  is  selected  in  the  SETUP  B
  2962.                          frame,  PC-VT  sends an EOT  character  (ASCII  4)
  2963.                          before it sends the BREAK.
  2964.  
  2965.  
  2966.  
  2967.           Page 40
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.           PC-VT v10.0                                 VT100 & 4014 Emulator
  2975.  
  2976.  
  2977.           ALT-X :        Resets XOFF Flag. If PC-VT  has  received  an XOFF
  2978.                          character, PC-VT stops transmitting. If you type a
  2979.                          character,  PC-VT beeps and ignores the key.  This
  2980.                          is  part  of the VT100  definition.  If  something
  2981.                          happens  and  PC-VT receives an  XOFF  because  of
  2982.                          garbage on the  line,  you can reset the XOFF flag
  2983.                          by  pressing  ALT-X.   PC-VT  tells  you  when  it
  2984.                          receives the XOFF  by  displaying  an  'X'  on the
  2985.                          status line.
  2986.  
  2987.           ALT-Z :        Hangs  up  the  phone.  PC-VT  performs  the  same
  2988.                          functions as if you had entered the  DIALING frame
  2989.                          and pressed F5. That is, the Hayes compatible hang
  2990.                          up command is sent to the modem.
  2991.  
  2992.  
  2993.           5.9  Scroll Buffer
  2994.  
  2995.  
  2996.                   When  you  press  the SCROLL LOCK key, you can have PC-VT
  2997.           recall previous screens  of  information.  PC-VT  saves  the last
  2998.           eight 80 column screens or the last five 132 column screens.
  2999.  
  3000.                   To start this feature, set the Scroll Buffer selection in
  3001.           the SETUP B frame. This feature  needs  a lot of memory and PC-VT
  3002.           tries to get it from DOS. If PC-VT  can't  get  the  memory, this
  3003.           feature will not function even if selected.
  3004.  
  3005.                   You  can start this feature manually  as  well  from  the
  3006.           VT100 communications frame by pressing ALT-S. If you  do  set the
  3007.           bit in the  SETUP  B  frame,  then PC-VT attempts to allocate the
  3008.           Scrolling Buffer each time that it starts. The  DMA  feature must
  3009.           also be selected  in  the  SETUP  B frame since the Scroll Buffer
  3010.           directly accesses video memory.
  3011.  
  3012.                   To activate  the recall, press the SCROLL LOCK key. 'SCR'
  3013.           appears on the status line. At this point, you can scroll through
  3014.           the previous screens by pressing these keys:
  3015.  
  3016.  
  3017.           PgUp :         recalls  the  previous screens, one  screen  at  a
  3018.                          time.
  3019.  
  3020.           PgDn :         moves forward one screen at a time.
  3021.  
  3022.           Home :         recalls the oldest information in the buffer.
  3023.  
  3024.           Up Arrow :     recalls the previous screens one line at a time.
  3025.  
  3026.           Down Arrow :   once you go backward in the buffer, this key moves
  3027.                          forward one line at a time.
  3028.  
  3029.           End :          recalls  the  last active screen  but  remains  in
  3030.                          Scroll Buffer mode.
  3031.  
  3032.  
  3033.                                                                     Page 41
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.           VT100 Keyboard Assignments                            PC-VT v10.0
  3041.  
  3042.  
  3043.           SCROLL LOCK :  clears  the Scroll Lock, displays the last  active
  3044.                          screen, and resets the screen to normal operation.
  3045.  
  3046.           Shift PrtSc :  prints the screen on the  printer.  You  can print
  3047.                          any previous screen by using the movement keys and
  3048.                          then pressing this key.
  3049.  
  3050.           Keypad + (plus):
  3051.                          dumps the screen  onto  a  disk  file.  The screen
  3052.                          information is appended to the file if  it already
  3053.                          exists.  The  file is named  SCRNDUMP.DAT  and  is
  3054.                          created on the  default drive. Trailing spaces are
  3055.                          removed from  each  screen  line  as  the  data is
  3056.                          written to disk. You can dump any  previous screen
  3057.                          by using the movement keys and then  pressing this
  3058.                          key.
  3059.  
  3060.           Keypad - (minus) :
  3061.                          dumps the entire Scroll Buffer onto  a  disk file.
  3062.                          The  Scroll Buffer information is appended to  the
  3063.                          file if  it  already  exists.  The  file  is named
  3064.                          SCRNDUMP.DAT and is  created on the default drive.
  3065.                          Trailing spaces are  removed from each screen line
  3066.                          as the data is written to disk.
  3067.  
  3068.                   The scrolling stops at each end of the  buffer.  That is,
  3069.           once you reach the oldest line, pressing the Up Arrow or PgUp key
  3070.           does nothing.
  3071.  
  3072.                   The Scrolling  Buffer  is  cleared  whenever  you  switch
  3073.           between 80 and 132 column modes.
  3074.  
  3075.  
  3076.           5.10  Keyboard Redefinition
  3077.  
  3078.  
  3079.                   You can download new  definitions  for  all  function and
  3080.           editing keys  in both numeric keypad and application keypad modes
  3081.           for both the VT100 and VT52 emulators.
  3082.  
  3083.                   The escape sequence is:
  3084.  
  3085.           ESC [ Pt ; Pk ; "string" p
  3086.  
  3087.           sets extended key Pk in translation table Pt to the string given.
  3088.           The double quotes and  all  other  characters shown are required.
  3089.           The numbers Pt and Pk must be sent as ASCII characters  just like
  3090.           all other sequences.
  3091.  
  3092.                   An  error  code  is available with the "ESC [ ?  1  0  n"
  3093.           sequence. See the technical appendix.
  3094.  
  3095.                   The string can be  any  sequence  of ASCII characters. It
  3096.           cannot include a carriage return or escape character. If you need
  3097.  
  3098.  
  3099.           Page 42
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3107.  
  3108.  
  3109.           to include a carriage return, use the tilde character '~'. If you
  3110.           need an  escape character, use the underline character '_'. PC-VT
  3111.           translates them when it processes the string.
  3112.  
  3113.                   Pt indicates the internal  table  which  is  changed. The
  3114.           tables are:
  3115.  
  3116.                          0       Reserved    to    indicate    Macro    Key
  3117.                          redefinition. See Chapter 10.
  3118.                          1 VT100 Numeric Keypad Mode.
  3119.                          2 VT52 Numeric Keypad Mode.
  3120.                          3 VT100 Application Keypad Mode if VMS and EDT are
  3121.                          selected in SETUP B.
  3122.                          4  VT100  Application   Keypad  Mode  if  UNIX  is
  3123.                          selected in SETUP B.
  3124.                          5 VT52 Application Keypad Mode.
  3125.                          6 VT100 Application Keypad Mode if VMS and EVE are
  3126.                          selected.
  3127.                          7-15 Reserved.
  3128.  
  3129.                   Pk indicates the  extended  function or editing key to be
  3130.           redefined. They are:
  3131.  
  3132.                          3 ......................................... CTRL-@
  3133.                          15 ..................................... SHIFT-Tab
  3134.                          16-25 .................... ALT-Q,W,E,R,T,Y,U,I,O,P
  3135.                          30-38 ...................... ALT-A,S,D,F,G,H,J,K,L
  3136.                          44-50 .......................... ALT-Z,X,C,V,B,N,M
  3137.                          59-68 ................................ F1 thru F10
  3138.                          71 .......................................... Home
  3139.                          72 ...................................... Up Arrow
  3140.                          73 .......................................... PgUp
  3141.                          74 .............................. Keypad Minus Key
  3142.                          75 .................................... Left Arrow
  3143.                          77 ................................... Right Arrow
  3144.                          78 ............................... Keypad Plus Key
  3145.                          79 ........................................... End
  3146.                          80 .................................... Down Arrow
  3147.                          81 .......................................... PgDn
  3148.                          82 ........................................... Ins
  3149.                          83 ........................................... Del
  3150.                          84-93 .......................... SHIFT-F1 thru F10
  3151.                          94-103 .......................... CTRL-F1 thru F10
  3152.                          104-113 .......................... ALT-F1 thru F10
  3153.                          115 .............................. CTRL-Left Arrow
  3154.                          116 ............................. CTRL-Right Arrow
  3155.                          117 ..................................... CTRL-End
  3156.                          118 .................................... CTRL-PgDn
  3157.                          119 .................................... CTRL-Home
  3158.                          120-129 ............................. ALT-1 thru 0
  3159.                          130 ................................... ALT-(dash)
  3160.                          131 .................................. ALT-(equal)
  3161.                          132 .................................... CTRL-PgUp
  3162.  
  3163.  
  3164.  
  3165.                                                                     Page 43
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.           VT100 Keyboard Assignments                            PC-VT v10.0
  3173.  
  3174.  
  3175.                   Remember that Application Keypad Mode is set and reset by
  3176.           the host computer. You can tell that it is selected because PC-VT
  3177.           displays the Greek letter alpha in the middle of the status line.
  3178.           Application Keypad Mode is usually set by editors,  such  as EDT,
  3179.           EVE and VI, and other programs,  such  as VMS Mail, which use the
  3180.           full screen capabilities of the VT100.
  3181.  
  3182.                   PC-VT can handle up  to  1000  characters of new strings.
  3183.           After that, additional redefinitions are ignored.  The  change is
  3184.           permanent until PC-VT is terminated and restarted.
  3185.  
  3186.                   Caution : if you redefine CTRL-F8, the user  will  not be
  3187.           able to terminate PC-VT without turning off the PC.
  3188.  
  3189.                   Examples (spaces for clarity only):
  3190.  
  3191.                          To set the Home key  in  the  Numeric  Keypad mode
  3192.                          table:
  3193.  
  3194.           ESC [ 1 ; 71 ; "run able~dir~set def [dir1.dir2]~logout~" p
  3195.  
  3196.                          To set  the  PgDn  key  in  the  VT100 Application
  3197.                          Keypad Mode VMS  table  to  produce  a  down arrow
  3198.                          sequence:
  3199.  
  3200.           ESC [ 3 ; 80 ; "_OB" p
  3201.  
  3202.                          To  set  the  ALT-H  key  to send the  PF2  Escape
  3203.                          sequence   followed   by   the  Keypad  Enter  key
  3204.                          sequence:
  3205.  
  3206.           ESC [ 3 ; 35 ; "_OQ_OM" p
  3207.  
  3208.  
  3209.                   This redefinition can also be done locally within the PC.
  3210.           Use  your  favorite  text editor and create a file which contains
  3211.           all of the redefinitions which you wish to make.  Then  start  up
  3212.           PC-VT. Use the "view a file" option of Transmit (Upload)  file to
  3213.           have PC-VT send the file to itself. PC-VT  interprets  the Escape
  3214.           sequences and redefines the keys. For more information on viewing
  3215.           a file, see the Chapter 8 section titled Viewing Files or look in
  3216.           the index under Viewing a File.
  3217.  
  3218.                   Here is an example of a file which when received by PC-VT
  3219.           will  cause the KEYPAD to map in a reasonable way for the VMS EVE
  3220.           editor. This mapping is the same as the mapping which you  get if
  3221.           you select EVE keypad support in the SETUP B frame.
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.           Page 44
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3239.  
  3240.  
  3241.           Assign KEYPAD Keys for the EVE/TPU VMS Text Editor
  3242.           -------------------------------------------------
  3243.           (Home) = Find    <ESC>[3;71;"_OP"p
  3244.           (up arrow) = Up Arrow <ESC>[3;72;"_Ou"p
  3245.           (PgUp) = Prev Screen <ESC>[3;73;"_On"p
  3246.           (left arrow) = Left Arrow <ESC>[3;75;"_Oq"p
  3247.           (right arrow) = Right Arrow <ESC>[3;77;"_Os"p
  3248.           (End) = Select <ESC>[3;79;"_Ow"p
  3249.           (down arrow) = Down Arrow <ESC>[3;80;"_Or"p
  3250.           (PgDn) = Next Screen <ESC>[3;81;"_Op"p
  3251.           (Ins) = Insert Here <ESC>[3;82;"_Oy"p
  3252.           (Del) = Remove <ESC>[3;83;"_Ox"p
  3253.           (ctrl Home) = Help <ESC>[3;119;"_OQ"p
  3254.           (ctrl PgUp) = Do <ESC>[3;132;"_OS"p
  3255.           (ctrl right arrow) = Move by Line <ESC>[3;116;"_Om"p
  3256.           (ctrl End) = Forward/Reverse <ESC>[3;117;"_OR"p
  3257.           (ctrl PgDn) = Erase Word <ESC>[3;118;"_Ol"p
  3258.           (ctrl left arrow) = Insert Overstrike <ESC>[3;115;"_OM"p
  3259.           EOF
  3260.  
  3261.                   You must replace the word <ESC> with the escape character
  3262.           (ASCII 27).
  3263.  
  3264.                   Note: The Pt >  0  sequence can be used to reassign Macro
  3265.           Keys as well as any other key. If this is used, the user will not
  3266.           see the reassignment in the MACRO frame. You should use the  Pt =
  3267.           0 sequence for Macro key reassignment.
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.                                                                     Page 45
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.           VT100 Keyboard Assignments                            PC-VT v10.0
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.           Page 46
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.                                       Chapter 6
  3380.  
  3381.                                     SETUP Frames
  3382.  
  3383.  
  3384.                   The SETUP frames are accessed  by  pressing  CTRL-F1 from
  3385.           the VT100 communications frame. SETUP  A  is  entered  first. The
  3386.           contents  of  the  communications  frame  are  preserved  and are
  3387.           restored when you exit SETUP.
  3388.  
  3389.                   The SETUP frames let you set program defaults used by all
  3390.           of the emulators within PC-VT.
  3391.  
  3392.                   PC-VT includes nine  frames  in which you can control the
  3393.           operation of the emulator.
  3394.  
  3395.  
  3396.           6.1  SETUP A
  3397.  
  3398.  
  3399.  
  3400.  
  3401.                   The SETUP A frame is used to perform the functions listed
  3402.           below. The bottom two lines of the frame represent the  tab stops
  3403.           which are set. The bottom line counts the columns  and  the  line
  3404.           above it shows  a "T" in each column where a tab is set. Here are
  3405.           the functions  available in SETUP A:
  3406.  
  3407.  
  3408.           Exit SETUP :   The ESC key or the CTRL-F1 key combination returns
  3409.                          PC-VT to the communications frame.  If unsolicited
  3410.                          terminal  parameter  reported  is enabled in VT100
  3411.                          emulation  mode,  the   terminal   parameters  are
  3412.                          reported.  This does not occur in VT102  emulation
  3413.                          mode.
  3414.  
  3415.           Reset :        The "0"  key  clears  the  tabs  and  features and
  3416.                          reloads them  from  the  USER  MEMORY  disk  file,
  3417.                          PARAMS.DAT,  on  the  default  drive.  PC-VT  then
  3418.                          returns to the communications frame.
  3419.  
  3420.           Set/Clear Tabs:
  3421.                          The "2" key sets  or  clears  a  tab at the column
  3422.                          position of the cursor. The left and right arrows,
  3423.                          the tab key, the space  bar, and the ENTER key can
  3424.                          be used to move the  cursor to the column in which
  3425.                          you want to set or clear the tab. A "T" appears to
  3426.                          indicate that a tab was  set or the "T" is blanked
  3427.  
  3428.  
  3429.                                                                     Page 47
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.           SETUP Frames                                          PC-VT v10.0
  3437.  
  3438.  
  3439.                          to indicate that  a  tab  was  cleared.  In either
  3440.                          case, the  character  is  highlighted  to indicate
  3441.                          that a change was made.
  3442.  
  3443.           Clear All Tabs:
  3444.                          The "3" key clears all tab stops. All  of  the "T"
  3445.                          tab stop indicators are cleared.
  3446.  
  3447.           Go to SETUP B :
  3448.                          The "5" key selects the SETUP B frame.
  3449.  
  3450.           Store into USER MEMORY:
  3451.                          The "S" key stores all currently set tab stops and
  3452.                          features selected by  SETUP  B onto a disk file on
  3453.                          the PC-DOS  default drive. The name of the file is
  3454.                          PARAMS.DAT.
  3455.  
  3456.           Reset :        The "R"  key  clears  the  tabs  and  features and
  3457.                          reloads them  from  the  USER  MEMORY  disk  file,
  3458.                          PARAMS.DAT, on the default drive. PC-VT remains in
  3459.                          the SETUP A frame.
  3460.  
  3461.           Select General Default:
  3462.                          The "D"  key clears any user set tabs and features
  3463.                          (from SETUP B) and resets  them  to  PC-VT defined
  3464.                          defaults.
  3465.  
  3466.           Select Tab Default:
  3467.                          The "T" key clears  any  user  set tabs and resets
  3468.                          them to every 8 columns as follows:
  3469.  
  3470.                          Columns 9, 17, 25, 33, 41, 49, 57, 65, and 73.
  3471.  
  3472.                          A  "T" appears in each of  these  columns  on  the
  3473.                          second line from  the  bottom of the SETUP A frame
  3474.                          to indicate that a tab is set.
  3475.  
  3476.           Incr/Decr Line Turnaround Character = xx (ASCII : y) :
  3477.                          This  character is used in conjunction with  ASCII
  3478.                          file upload.  When uploading, PC-VT can be told to
  3479.                          wait for this character (the =t option) to be sent
  3480.                          by the Host before PC-VT sends the next line.  For
  3481.                          our purposes, a line ends when  a  carriage return
  3482.                          (ASCII  13)  is  uploaded.  The value of xx is the
  3483.                          ASCII value  of the character, and y is the actual
  3484.                          ASCII  character.  The character is not  displayed
  3485.                          if  it  is  less than 32 or equal to 255.  The "L"
  3486.                          key  increments this value and the "K"  decrements
  3487.                          it.    You  must  execute  a "S - store into  USER
  3488.                          MEMORY" command to  save  the  new  value  of this
  3489.                          character on disk.  Otherwise, the next  time that
  3490.                          you  start PC-VT, the original value is  restored.
  3491.                          The  first time that PC-VT starts, this  character
  3492.                          is set to the dollar sign character, ASCII 36.
  3493.  
  3494.  
  3495.           Page 48
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3503.  
  3504.  
  3505.           6.2  SETUP B
  3506.  
  3507.  
  3508.                   The SETUP B frame is used to perform the functions listed
  3509.           below. The bottom line of the frame represents the features which
  3510.           are  set  or  reset.  See  the  next  section  for details of the
  3511.           features.  The  number  of data bits  and  the  parity  type  are
  3512.           displayed. The COM port speed is displayed. The selected COM port
  3513.           is displayed.  LPTx is displayed to indicate the selected printer
  3514.           (either LPT1 or LPT2).
  3515.  
  3516.                   The currently selected host is displayed in the center of
  3517.           the screen. If  no  host  has  been selected in the DIALER frame,
  3518.           this field displays as  all  periods.  See  Chapter 9 for details
  3519.           about saving unique host setup information.
  3520.  
  3521.                   The default file transfer mode  is  displayed.  This mode
  3522.           will  be  used  whenever  a  file transfer is started without  an
  3523.           option.  Toggle  through  the  options  by  using  the  "x"  key.
  3524.           Permanently save the selected option by pressing "s" in the SETUP
  3525.           A frame to  save  the  USER  MEMORY  on disk. Modes which are not
  3526.           supported in both receive and transmit are set as follows:
  3527.  
  3528.  
  3529.                                   Receive                 Transmit
  3530.           Mode                    File                    File
  3531.           XMODEM                  XMODEM                  XMODEM
  3532.           XMODEM CRC              XMODEM CRC              XMODEM CRC
  3533.           ASCII (wait for LF)     ASCII (wait for LF)     ASCII
  3534.           ASCII (immediate)       ASCII (immediate)       ASCII
  3535.           ASCII (CTRL-Z)          ASCII                   ASCII (CTRL-Z)
  3536.           ASCII with Turnaround   ASCII                   ASCII with
  3537.           Turnaround
  3538.           View a File             ASCII                   View a File
  3539.           KERMIT                  KERMIT                  KERMIT
  3540.  
  3541.           See Chapter 8 for details on each of these modes.
  3542.  
  3543.                   The selected monitor  mode  is  displayed  to  show which
  3544.           monitor is being used by PC-VT. The monitor mode is selected when
  3545.           you first start up PC-VT and are saved  when  you  save  the USER
  3546.           MEMORY data on  disk.  Check  the  index  entry  on  Command Line
  3547.           Options for more information. Monitor modes are:
  3548.  
  3549.           Default:       PC-VT uses either the IBM  monochrome  or  the IBM
  3550.                          Color  Graphics  Adapter  whichever is the default
  3551.                          monitor when PC-VT is stated.
  3552.  
  3553.           Both:          PC-VT uses both  the  IBM  monochrome  or  the IBM
  3554.                          Color Graphics Adapters. The monochrome monitor is
  3555.                          used for VT emulation and the CGA is used for 4014
  3556.                          emulation.
  3557.  
  3558.  
  3559.  
  3560.  
  3561.                                                                     Page 49
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.           SETUP Frames                                          PC-VT v10.0
  3569.  
  3570.  
  3571.           Everex Edge:   PC-VT  uses  the  Everex  Edge card and monochrome
  3572.                          monitor  for both VT and 4014 Emulation.  Supports
  3573.                          132 column mode in the  VT emulator and 720 by 348
  3574.                          high resolution graphics in the 4014 emulator.
  3575.  
  3576.           Hercules:      PC-VT   uses   the   Hercules  Graphics  card  and
  3577.                          monochrome monitor for both VT and 4014 Emulation.
  3578.                          Supports 720 by 348  high  resolution  graphics in
  3579.                          the 4014 emulator.
  3580.  
  3581.                   Here are the functions available in the SETUP B frame:
  3582.  
  3583.  
  3584.           Exit SETUP :   The ESC key  or  CTRL-F1 exits SETUP B and returns
  3585.                          to  the  communications   frame.   If  unsolicited
  3586.                          terminal  parameter  reported  is enabled in VT100
  3587.                          emulation  mode,  the   terminal   parameters  are
  3588.                          reported.  This does not occur in VT102  emulation
  3589.                          mode.
  3590.  
  3591.           Go to SETUP A :
  3592.                          The "5" key selects the SETUP A frame.
  3593.  
  3594.           Toggle 1/0:    The "6"  key sets(1) or resets(0) a feature at the
  3595.                          column position of the cursor. The left  and right
  3596.                          arrows, the  tab key, the space bar, and the ENTER
  3597.                          key can be used to move the cursor  to  the column
  3598.                          in which you want to  set  or  clear  the feature.
  3599.                          Features displayed  with  an  "X"  are  set  to an
  3600.                          automatic default  and  cannot  be  changed. Other
  3601.                          features change from a "1" to a "0" or from  a "0"
  3602.                          to a "1" to indicate that the state of the feature
  3603.                          has  been  changed.  Features marked as "Reserved"
  3604.                          should not be toggled. The digit is highlighted to
  3605.                          indicate that a change was made. To preserve these
  3606.                          features in  your USER MEMORY disk file use the "S
  3607.                          - Store into  USER  MEMORY" command in the SETUP A
  3608.                          frame. Otherwise, the  old values will be reloaded
  3609.                          the next time PC-VT starts.
  3610.  
  3611.           COM Port Selection :
  3612.                          COM1 or COM2  can  be selected by flipping the 4th
  3613.                          bit  of  the  6th  group  of feature bits  on  the
  3614.                          bottom of the SETUP B frame. The word COM1 or COM2
  3615.                          displays next to  the  word MODEM on this frame to
  3616.                          indicate which RS232  port  is in use by PC-VT. To
  3617.                          change ports, just go to SETUP B frame, space over
  3618.                          to the 4th bit of the 6th group and then press the
  3619.                          "6" key. This causes the 1 or 0 in the feature bit
  3620.                          to  flip.  Then  return to the SETUP  A  frame  by
  3621.                          pressing "5" and store  the  new  value  into USER
  3622.                          MEMORY by pressing "S".
  3623.  
  3624.  
  3625.  
  3626.  
  3627.           Page 50
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3635.  
  3636.  
  3637.           Modem Speed Control:
  3638.                          The "7" key causes PC-VT  to  display  the various
  3639.                          modem  speeds  supported. The  currently  selected
  3640.                          speed is displayed under the  MODEM  title  on the
  3641.                          screen.  Press  the  "7"  key repeatedly until the
  3642.                          speed  you  need  is  displayed.    The  new speed
  3643.                          selected is highlighted  to indicate that a change
  3644.                          was made. The supported speeds are:
  3645.  
  3646.                                100 baud                150 baud
  3647.                                300 baud                600 baud
  3648.                               1200 baud (default)     2400 baud
  3649.                               4800 baud               9600 baud
  3650.  
  3651.                          To  preserve  this speed selection  in  your  USER
  3652.                          MEMORY  disk file use the "S  -  Store  into  USER
  3653.                          MEMORY"  command in the SETUP A frame.  Otherwise,
  3654.                          the old  values will be reloaded the next time PC-
  3655.                          VT starts.
  3656.  
  3657.           Select Data/Parity Bits:
  3658.                          The "P" key causes PC-VT  to  display  the various
  3659.                          data  bits/parity  bits supported.  The  currently
  3660.                          selected  Data  bits/Parity  bits  combination  is
  3661.                          displayed  on  the  screen  under the MODEM title.
  3662.                          Press  the  "P"  key  repeatedly  until  the  data
  3663.                          bits/parity   bits   combination   you   need   is
  3664.                          displayed. The  new  selection  is  highlighted to
  3665.                          indicate  that  a  change  was made. The supported
  3666.                          combinations are:
  3667.  
  3668.                               7O ...... 7 data bits - odd parity
  3669.                               7E ...... 7 data bits - even parity
  3670.                               7N ...... 7 data bits - no parity
  3671.                               8O ...... 8 data bits - odd parity
  3672.                               8E ...... 8 data bits - even parity
  3673.                               8N ...... 8 data bits - no parity
  3674.                               (default)
  3675.  
  3676.                          The 7E setting is  the  best  for  UNIX and the 8N
  3677.                          setting is best for VMS.
  3678.  
  3679.                          To preserve these Data bit/Parity bit combinations
  3680.                          in your USER MEMORY disk file use the  "S  - Store
  3681.                          into USER  MEMORY" - command in the SETUP A frame.
  3682.                          Otherwise,  the  old  values  will be reloaded the
  3683.                          next time  PC-VT starts. If you are running a 212A
  3684.                          modem,  certain  of  the data bits/parity/stop bit
  3685.                          combinations are invalid. Check your  modem manual
  3686.                          for the valid combinations.
  3687.  
  3688.                          Note  that  actual  parity  checking is enabled by
  3689.                          setting  a feature in this frame. Parity  checking
  3690.                          defaults to off. See the next section.
  3691.  
  3692.  
  3693.                                                                     Page 51
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.           SETUP Frames                                          PC-VT v10.0
  3701.  
  3702.  
  3703.           Set Answerback Message:
  3704.                          The "A" key  permits  you to enter a message which
  3705.                          PC-VT  uses  to  respond  to  an  Enquire  control
  3706.                          character. Any character with an ASCII code from 0
  3707.                          to 127 can be entered in  this  message (Including
  3708.                          the use of the ALT key and the numbers on the PC's
  3709.                          keypad to enter  special characters). To enter the
  3710.                          message,  press "A".  PC-VT  displays  the  prompt
  3711.                          "A=". The prompt  is highlighted and blinking. You
  3712.                          may then type in the message. The  first character
  3713.                          typed  is  considered  a  delimiter by PC-VT. This
  3714.                          character must not be  present  in  the answerback
  3715.                          message itself and is  used  only  to  bracket the
  3716.                          message  since  control characters  like  carriage
  3717.                          return can be part of the  message.  Following the
  3718.                          message,  type the  delimiter  character  and  the
  3719.                          message is stored in memory.
  3720.  
  3721.                          If you make a  typing  mistake,  you must type the
  3722.                          delimiter  character  and  start the process over.
  3723.                          This is  because the backspace key does not act as
  3724.                          a text editor  but  is actually entered as part of
  3725.                          the answerback  message.  While  you  are entering
  3726.                          this message, non-displayable characters are shown
  3727.                          as  a  diamond.  The  message  is  highlighted  to
  3728.                          indicate that a change is being made.  To preserve
  3729.                          this message in your USER MEMORY disk file use the
  3730.                          "S  - Store into USER MEMORY"  -  command  in  the
  3731.                          SETUP A frame. Otherwise, the old message, if any,
  3732.                          will be reloaded the next time PC-VT starts.
  3733.  
  3734.                          The  default answerback message is null, that  is,
  3735.                          nothing  is transmitted in response to an  Enquire
  3736.                          control character.
  3737.  
  3738.                          The ALT-B key on the PC emulates the  HERE  IS key
  3739.                          on  the  VT  and causes this message to be sent to
  3740.                          the host.
  3741.  
  3742.           Change Default File Transfer Mode:
  3743.                          The "X"  key  lets  you  change  the  default file
  3744.                          transfer  mode.  Pressing  that  key   shows  each
  3745.                          possible mode. To  preserve this selection in your
  3746.                          USER MEMORY disk file use the "S - Store into USER
  3747.                          MEMORY" - command in the SETUP A frame. Otherwise,
  3748.                          the old transfer mode  will  be  set the next time
  3749.                          PC-VT starts.
  3750.  
  3751.  
  3752.           6.2.1  SETUP B Features and Defaults
  3753.  
  3754.  
  3755.                   The  SETUP  B  frame is used to select features of PC-VT.
  3756.           The  features are listed below along  with  their  defaults.  The
  3757.  
  3758.  
  3759.           Page 52
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3767.  
  3768.  
  3769.           procedures for changing and saving these features  were described
  3770.           in the first part of this section. As you move the  cursor across
  3771.           the  bottom  of  the  frame   using  the  cursor  keys,  a  short
  3772.           description  of the meaning of the feature  and  its  values  are
  3773.           displayed.
  3774.  
  3775.                   A  default  of  (X)  indicates  that the feature  is  not
  3776.           supported or   is  reserved.  The  default  values  are  shown in
  3777.           parentheses.
  3778.  
  3779.  
  3780.           Group 1
  3781.  
  3782.  
  3783.           Scroll (X)     The design of  the  IBM PC does not support smooth
  3784.                          scroll.
  3785.  
  3786.           Auto Repeat (1)
  3787.                          0 = Disable autorepeat. PC-VT can only approximate
  3788.                          this function  since  it  is  handled  within  the
  3789.                          keyboard.  PC-VT clears the keyboard buffer  after
  3790.                          each  key  is read. This  effectively  clears  the
  3791.                          buffer of any auto repeated characters.
  3792.  
  3793.                          1 = Enable autorepeat.
  3794.  
  3795.           Screen Background (0)
  3796.                          0 = dark background
  3797.  
  3798.                          1 = light background
  3799.  
  3800.           Cursor (0)     0 = underline cursor
  3801.  
  3802.                          1 = block cursor
  3803.  
  3804.  
  3805.           Group 2
  3806.  
  3807.  
  3808.           Margin Bell (0)
  3809.                          Selects margin bell.
  3810.                          0 = Off
  3811.  
  3812.                          1 = On
  3813.                          If this feature  is  turned  on,  PC-VT  beeps the
  3814.                          speaker each time that the cursor  enters  the 8th
  3815.                          rightmost column  from  the  9th  rightmost column
  3816.                          under control of the keyboard  or  the  host. This
  3817.                          feature is best used when entering  text  from the
  3818.                          keyboard.  Any  other  use may cause unpredictable
  3819.                          results especially in full screen modes.
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.                                                                     Page 53
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.           SETUP Frames                                          PC-VT v10.0
  3833.  
  3834.  
  3835.           VMS Editor Support (0)
  3836.                          Selects  Keypad  mapping  for  VMS   editor.  Also
  3837.                          selectable from the host, see Appendix J.
  3838.                          0 = Keypad supports the EDT editor.
  3839.  
  3840.                          1 = Keypad supports the EVE editor.
  3841.  
  3842.           ANSI/VT52 (1)  Selects terminal mode.
  3843.                          0 = VT52 compatibility mode.
  3844.  
  3845.                          1  = ANSI mode. That is,  either  VT100  or  VT102
  3846.                          depending on the setting of the Terminal  Type bit
  3847.                          in Group 6 below.
  3848.  
  3849.           Auto XON/XOFF (1)
  3850.                          0 = XOFF is ignored. PC-VT's  buffer  may overflow
  3851.                          without warning or indication.
  3852.  
  3853.                          1  =  XOFF stops PC-VT  from  transmitting.  PC-VT
  3854.                          stops  transmitting characters  when  an  XOFF  is
  3855.                          received and transmits an  XOFF  when  75%  of its
  3856.                          receive buffer is  full (1536 characters). It then
  3857.                          transmits XON when the buffer has been  emptied to
  3858.                          10% full (204 characters). If the host ignores the
  3859.                          XOFF  character  and  continues  to   send,  PC-VT
  3860.                          displays a '#' character to indicate that data has
  3861.                          been lost.  When PC-VT receives an XOFF, an 'X' is
  3862.                          displayed in  column 41 of the status line. If you
  3863.                          try to type a character when the 'X' is displayed,
  3864.                          PC-VT beeps and rejects  it.  If  the 'X' comes on
  3865.                          because  of noise on the communications line,  you
  3866.                          can clear it by  pressing  the  ALT-X key. See the
  3867.                          ALT-X  key  definition in the  appendix  for  more
  3868.                          details.
  3869.  
  3870.  
  3871.           Group 3
  3872.  
  3873.  
  3874.           Character Set (0)
  3875.                          0 = Selects US Characters. The US character set is
  3876.                          selected as the default.
  3877.  
  3878.                          1 = Selects UK Characters. The UK character set is
  3879.                          selected as the default.
  3880.                          (Note that the only difference between the  two is
  3881.                          the SHIFT-3 character. In  the  US  set, it is the
  3882.                          "#" sign. In the UK set, it is the UK Pound sign.)
  3883.  
  3884.           Auto Wrap (0)  0 = Auto wrap  off.  If the cursor is at the right
  3885.                          margin  and  another  character is received, PC-VT
  3886.                          displays that character and all following received
  3887.                          characters   at   the   right   margin   position,
  3888.                          effectively writing over one another.
  3889.  
  3890.  
  3891.           Page 54
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.           PC-VT v10.0                                 VT100 & 4014 Emulator
  3899.  
  3900.  
  3901.                          1 = Auto wrap on -  If  the cursor is at the right
  3902.                          margin  and  another  character is received, PC-VT
  3903.                          performs a  carriage  return  and  linefeed before
  3904.                          displaying that character. Be careful when you use
  3905.                          this feature. When performing full screen editing,
  3906.                          the host  may lose track of the cursor position if
  3907.                          you set autowrap  locally  in PC-VT and you do not
  3908.                          inform the host. In VMS, look at the  SET  TERM as
  3909.                          well as commands in the EDT editor.
  3910.  
  3911.           Linefeed / New Line (0)
  3912.                          0  =  LF/NL  off  -  Pressing ENTER sends  only  a
  3913.                          carriage return  to the host. The host must echo a
  3914.                          carriage return and linefeed to move the cursor to
  3915.                          the beginning of the next line.
  3916.  
  3917.                          1  =  LF/NL  on  -  Pressing  ENTER  sends both  a
  3918.                          carriage return and  a  linefeed  to  the  host. A
  3919.                          linefeed is processed just like a carriage return.
  3920.  
  3921.           Local Echo (0)
  3922.                          0 = Local echo off. - The host must echo  back all
  3923.                          typed characters in order for them to be displayed
  3924.                          on   the  screen.  Linefeed  characters  are   not
  3925.                          transmitted  during an ASCII file transfer.
  3926.  
  3927.                          1 = Local echo on -  PC-VT  automatically displays
  3928.                          all characters typed. The host need not  echo them
  3929.                          back. Linefeed characters  are  transmitted during
  3930.                          an ASCII file transfer.
  3931.  
  3932.  
  3933.           Group 4
  3934.  
  3935.  
  3936.           Print Termination Character (1)
  3937.                          0 = none - No control characters are  sent  to the
  3938.                          printer following a print screen operation.
  3939.  
  3940.                          1 = Form feed - A form feed is sent to the printer
  3941.                          following a print screen operation.
  3942.  
  3943.           Print Extent (1)
  3944.                          0 = Scrolling region -  A  print  screen operation
  3945.                          prints the scrolling region  as  set  by  the host
  3946.                          computer only.
  3947.  
  3948.                          1 =  Full screen - A print screen operation prints
  3949.                          the entire screen.
  3950.  
  3951.           Stop Bits (0)  0 = 1 stop bit is used by the RS232 interface.
  3952.  
  3953.                          1 = 2 stop bits are used by the RS232 interface.
  3954.  
  3955.  
  3956.  
  3957.                                                                     Page 55
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.           SETUP Frames                                          PC-VT v10.0
  3965.  
  3966.  
  3967.           Receive Parity (0)
  3968.                          0 = Parity on received data is not checked.
  3969.  
  3970.                          1 = Parity checking is enabled.  PC-VT  displays a
  3971.                          '!' character in place of the  character  with the
  3972.                          bad parity.
  3973.  
  3974.  
  3975.           Group 5
  3976.  
  3977.  
  3978.           Backspace (0)  0 = Send the  backspace  key as 7Fh (ASCII 127)  -
  3979.                          the VT100 DELETE key.
  3980.  
  3981.                          1  =  Send  the backspace key as 08h  - the IBM PC
  3982.                          standard. When you are doing this,  you  can still
  3983.                          send a DEL (ASCII 127) by  pressing  ALT-=. (Press
  3984.                          the ALT key and  the  equal  sign  key at the same
  3985.                          time.)
  3986.  
  3987.           Disconnect Character Enable (0)
  3988.                          0 = Terminal ignores the disconnect character.
  3989.  
  3990.                          1 = If PC-VT receives the  disconnect  character (
  3991.                          an EOT with an ASCII value of 4),  it  transmits a
  3992.                          sustained  Break and  disconnects  from  the  host
  3993.                          computer.
  3994.  
  3995.           Fast Screen (0)
  3996.                          0 =  Prevent  PC-VT  from  doing  direct  reads or
  3997.                          writes into video memory.  This  is  the  most DOS
  3998.                          compatible mode. It is also the slowest  mode. The
  3999.                          color graphics display adapter may not be  able to
  4000.                          keep up with 9600 baud  in this mode. Note that no
  4001.                          data will be  lost.  PC-VT will send XOFF and XON.
  4002.                          Must be set  to  0  for  TopView if you want to do
  4003.                          windowing.
  4004.  
  4005.                          1 = Permit PC-VT to  do  direct  reads  and writes
  4006.                          into   video  memory.   This   mode   will   cause
  4007.                          interference, or  "snow",  on  the  color graphics
  4008.                          display adapter but PC-VT should be  able  to keep
  4009.                          up with 9600 baud. For the  monochrome  card, this
  4010.                          setting has no effect.
  4011.  
  4012.           Operating System (1)
  4013.                          0 = The UNIX VI keypad mapping is selected for the
  4014.                          IBM PC keypad. Control-D is selected as the End of
  4015.                          File character for ASCII file upload.
  4016.  
  4017.                          1 = The VMS EDT keypad mapping is selected for the
  4018.                          IBM PC keypad. Control-Z is selected as the End of
  4019.                          File character for ASCII file upload.
  4020.                          See  Chapter  5  for  the  VT  keypad  mapping and
  4021.  
  4022.  
  4023.           Page 56
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4031.  
  4032.  
  4033.                          Chapter 8 for  ASCII file upload description. Also
  4034.                          selectable from the host, see Appendix J.
  4035.  
  4036.  
  4037.           Group 6
  4038.  
  4039.  
  4040.           Printer (0)    0 = LPT1 is selected.
  4041.  
  4042.                          1 = LPT2 is selected.
  4043.  
  4044.           Buffer Size (1)
  4045.                          0 = Use a 256 byte communications buffer.
  4046.  
  4047.                          1 = Use a 2048 byte communications buffer.
  4048.                          Use  of  the  larger  buffer causes fewer XON/XOFF
  4049.                          sequences  between  PC-VT and the  host.  It  also
  4050.                          slows the response to  CTRL-C,  CTRL-O  and CTRL-Y
  4051.                          commands. For some text editors which  do  not use
  4052.                          XON/XOFF, the larger buffer size works better.
  4053.  
  4054.           Terminal Type (0)
  4055.                          0 = PC-VT emulates a VT102.
  4056.  
  4057.                          1 = PC-VT emulates a VT100.
  4058.  
  4059.           COM Port (0)   0 = PC-VT uses COM1 as the communications port.
  4060.  
  4061.                          1 = PC-VT uses COM2 as the communications port.
  4062.  
  4063.  
  4064.           Group 7
  4065.  
  4066.  
  4067.           DMA (1)        0 = Prevents PC-VT from doing direct  memory reads
  4068.                          or writes  into  video  memory  while  saving  the
  4069.                          screen when you switch  into  the  SETUP  or other
  4070.                          auxiliary frame. The screen  will  still  be saved
  4071.                          but at the much slower pace of the  BIOS.  This is
  4072.                          the most DOS compatible mode. Must be set to 0 for
  4073.                          TopView if you want to do windowing.
  4074.  
  4075.                          1 = Permit PC-VT  to  use  direct memory reads and
  4076.                          writes  into video memory while saving the  screen
  4077.                          when you switch into the SETUP or  other auxiliary
  4078.                          frame. Permits operation of  Scroll  Buffer  - see
  4079.                          Group 10 below.
  4080.  
  4081.           Reserved (X)   Reserved for PC-VT.
  4082.  
  4083.           Clock (1)      0 = Do not display the clock and  MODEM  status on
  4084.                          the status line.
  4085.  
  4086.  
  4087.  
  4088.  
  4089.                                                                     Page 57
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.           SETUP Frames                                          PC-VT v10.0
  4097.  
  4098.  
  4099.                          1 = Display the time of day clock and MODEM status
  4100.                          on the status line.
  4101.  
  4102.           256 Char (0)   0 = If 8 bit data is selected for receive, the 8th
  4103.                          bit (high  order bit) is cleared to binary zero if
  4104.                          it is a binary one when  received.  PC-VT displays
  4105.                          characters only from the  first  128  ASCII codes.
  4106.                          (XMODEM always uses all 8 bits.)
  4107.  
  4108.                          1 = If 8 bit data is selected for receive, the 8th
  4109.                          bit is interpreted as the high order bit  of  an 8
  4110.                          bit  ASCII  character.  This permits 256 character
  4111.                          codes to be displayed on the screen. This is NOT a
  4112.                          VT function and  the  use of this option may cause
  4113.                          unpredictable results.
  4114.  
  4115.  
  4116.           Group 8
  4117.  
  4118.  
  4119.           CGA Underline (0)
  4120.                          0=Bold. PC-VT displays the underline  attribute as
  4121.                          bold on the Color Graphics Adapter.
  4122.  
  4123.                          1=Bold and Blinking. PC-VT displays  the underline
  4124.                          attribute as bold & blinking on the Color Graphics
  4125.                          Adapter.  The  monochrome  adapter  handles   this
  4126.                          attribute correctly as underline.
  4127.  
  4128.           Controls (0)   0=Interpret. PC-VT, when running as a VT emulator,
  4129.                          interprets and acts upon all escape sequences.
  4130.  
  4131.                          1=Display.   PC-VT   does   not  interpret  escape
  4132.                          sequences.  They are displayed on the screen  just
  4133.                          as  they  are received. The  escape  character  is
  4134.                          displayed as <ESC>.
  4135.  
  4136.           Columns (0)    0=80. PC-VT operates in normal 80 column mode.
  4137.  
  4138.                          1=132.  PC-VT  operates in 132  column  mode.  The
  4139.                          Everex Edge Monochrome/Color Graphics Adapter card
  4140.                          must  be  installed.  PC-VT  ignores   the  escape
  4141.                          sequence to go into  132  column  mode  unless you
  4142.                          have the card installed and you have started PC-VT
  4143.                          with the /e option on the command line.
  4144.  
  4145.           4014 Page Full (1)
  4146.                          0=Off
  4147.  
  4148.                          1=On. Causes a Page Full condition  to  occur when
  4149.                          the emulator linefeeds past the last  line  on the
  4150.                          screen. PC-VT beeps the speaker with  a  low pitch
  4151.                          tone and waits for the user to press  the  F2 key.
  4152.                          The  screen  is  cleared and displaying continues.
  4153.  
  4154.  
  4155.           Page 58
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4163.  
  4164.  
  4165.                          This must be  set  to  use  the  Autoprint feature
  4166.                          described below.
  4167.  
  4168.  
  4169.           Group 9
  4170.  
  4171.  
  4172.           4014 CR Effect (0)
  4173.                          0=CR only. PC-VT  transmits only a Carriage Return
  4174.                          code when the PC Enter key is pressed.
  4175.  
  4176.                          1=CR and  LF.  PC-VT  transmits  both  a  carriage
  4177.                          return and a  linefeed  code when the PC Enter key
  4178.                          is pressed.
  4179.  
  4180.           4014 LOY (1)   0=RUBOUT.  The RUBOUT  character  (ASCII  127)  is
  4181.                          ignored.
  4182.  
  4183.                          1=LOY. The RUBOUT character is  treated  as  a Low
  4184.                          Order Y coordinate address.
  4185.  
  4186.           4014 LF Effect (0)
  4187.                          0=LF only. PC-VT transmits  only  a  linefeed code
  4188.                          when the PC CTRL-J (linefeed) key is pressed.
  4189.  
  4190.                          1=LF and CR. PC-VT transmits both a linefeed and a
  4191.                          carriage  return  code  when  the  CTRL-J  key  is
  4192.                          pressed.
  4193.  
  4194.           4014 GIN Term. (1)
  4195.                          0=None. PC-VT only sends the  graphics coordinates
  4196.                          when GIN mode is terminated.
  4197.  
  4198.                          1=CR. PC-VT sends  a Carriage Return following the
  4199.                          graphics coordinates when GIN mode is terminated.
  4200.  
  4201.  
  4202.           Group 10 Shown as Group 0 on the frame.
  4203.  
  4204.  
  4205.           4014 Autoprint (0)
  4206.                          0=Off.
  4207.  
  4208.                          1=On. If the Page Full feature is set, a Page-Full
  4209.                          condition causes PC-VT to make a  hardcopy  of the
  4210.                          screen.  Completion of  the  hardcopy  clears  the
  4211.                          Page-Full condition and erases the screen.
  4212.  
  4213.           Scroll Buffer (0)
  4214.                          0=Do not attempt to allocate memory for the Scroll
  4215.                          Buffer. The Scroll Lock key  functions  as  the NO
  4216.                          SCROLL key on the VT100.  The  buffer  function is
  4217.                          disabled. Must be set to 0 for TopView if you want
  4218.                          to do windowing.
  4219.  
  4220.  
  4221.                                                                     Page 59
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.           SETUP Frames                                          PC-VT v10.0
  4229.  
  4230.  
  4231.                          1=Attempt  to  allocate  memory  for   the  Scroll
  4232.                          Buffer. Chapter 5  describes the operation of this
  4233.                          function.  This  feature  requires  that  the  DMA
  4234.                          feature be  selected  in  Group  7  above.  Scroll
  4235.                          Buffer directly accesses  video memory. Do not use
  4236.                          this feature if you already have a Scroll Lock key
  4237.                          handler installed.
  4238.  
  4239.           Screen Blanking (0)
  4240.                          0=Screen blanking is disabled.
  4241.  
  4242.                          1=PC-VT blanks the  VT emulator screen after three
  4243.                          minutes of inactivity. Receipt  of  data  from the
  4244.                          host or any key  press  turns  the screen back on.
  4245.                          Pressing the SHIFT key will turn  the  screen back
  4246.                          on without generating a character. This feature is
  4247.                          never active in 4014 mode. Do not use this feature
  4248.                          if  you  already have a  screen  blanking  program
  4249.                          installed.
  4250.  
  4251.           Reserved (X)   Reserved for PC-VT.
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.           Page 60
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.                                       Chapter 7
  4304.  
  4305.                                  The PARAMS.DAT File
  4306.  
  4307.  
  4308.                   PC-VT maintains a USER MEMORY  file on disk. This file is
  4309.           used to save user selected features and tab stops.  The  file  is
  4310.           read  each  time  that  you  start  up  PC-VT  so  your  selected
  4311.           configuration is restored each time.
  4312.  
  4313.  
  4314.           7.1  Creation
  4315.  
  4316.  
  4317.                   The file is automatically created with default  values as
  4318.           defined  in  Chapter  6 if the file does not exist on the default
  4319.           drive.
  4320.  
  4321.  
  4322.           7.2  Location
  4323.  
  4324.  
  4325.                   A file  named  PARAMS.DAT  is  created  in  the directory
  4326.           pointed  to by  the 'PC-VT='string in  the  environment.  If  you
  4327.           haven't specified that string,  the  file  is  created on the DOS
  4328.           default drive. Chapter 3 on starting PC-VT describes  how  to use
  4329.           this string.
  4330.  
  4331.  
  4332.           7.3  Updating
  4333.  
  4334.  
  4335.                   The file is rewritten upon request while in  the  SETUP A
  4336.           frame by pressing "s".
  4337.  
  4338.  
  4339.           7.4  Error Messages
  4340.  
  4341.  
  4342.                   There are  several  messages  generated  by  PC-VT  while
  4343.           manipulating this file.
  4344.  
  4345.  
  4346.           "New USER MEMORY File Created":
  4347.                          PC-VT  could  not  find  PARAMS.DAT on the default
  4348.                          disk drive so  it  created a file with the default
  4349.                          feature selections and tab stops. PC-VT continues.
  4350.  
  4351.  
  4352.  
  4353.                                                                     Page 61
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.           The PARAMS.DAT File                                   PC-VT v10.0
  4361.  
  4362.  
  4363.           "Disk Directory Full":
  4364.                          PC-VT could not find space in the directory of the
  4365.                          default disk drive when  it  tried  to  create the
  4366.                          PARAMS.DAT file. PC-VT terminates.
  4367.  
  4368.           "Disk Full While Writing USER MEMORY File":
  4369.                          PC-VT ran out  of  space on the default disk drive
  4370.                          while   creating   the  PARAMS.DAT   file.   PC-VT
  4371.                          terminates.
  4372.  
  4373.           "Disk Swap Error - See User Manual":
  4374.                          PC-VT found a different  diskette  in  the default
  4375.                          drive from the time that the  directory  entry was
  4376.                          created and the file PARAMS.DAT was written. Since
  4377.                          the time between these two events  is  very small,
  4378.                          this error message  indicates a severe hardware or
  4379.                          system  failure.  PC-VT  terminates.  This   error
  4380.                          should never happen  if  PC-VT is run from a fixed
  4381.                          disk.
  4382.  
  4383.           "Error While Opening USER MEMORY File":
  4384.                          PC-VT  failed to successfully open the  PARAMS.DAT
  4385.                          file on the default disk. This usually  means that
  4386.                          the   disk  directory  has  been  damaged.   PC-VT
  4387.                          terminates.
  4388.  
  4389.           "USER MEMORY File Access Error":
  4390.                          An error  occurred  while  reading  the PARAMS.DAT
  4391.                          file from the default disk. Usually means that the
  4392.                          file  has  been  accidentally  overwritten.  PC-VT
  4393.                          terminates.
  4394.  
  4395.           "Can't find PARAMS.DAT.F1 to cancel,space to try again.":
  4396.                          This usually means that the default diskette drive
  4397.                          is  empty  or  the  door  is  open.   Correct  the
  4398.                          situation and hit the space key to continue. Press
  4399.                          F1 to terminate PC-VT.
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.           Page 62
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.                                       Chapter 8
  4436.  
  4437.                           Transmitting and Receiving Files
  4438.  
  4439.  
  4440.                   PC-VT   has   complete   transmit  (upload)  and  receive
  4441.           (download) facilities. These facilities  are  accessed  using the
  4442.           CTRL-F4  and  CTRL-F3  keys, which are active whenever you are in
  4443.           either the VT100 or 4014  communications  frames.  PC-VT performs
  4444.           these functions on any ASCII character or binary file. The binary
  4445.           file  transfer  uses  the XMODEM protocol  and  must  be  over  a
  4446.           communications line set at 8 data bits, no parity, and 1 stop bit
  4447.           (PC-VT automatically switches the  communications  line  to 8-N-1
  4448.           before it starts an XMODEM transfer and restores  your  set value
  4449.           when  the  transfer  is complete). XMODEM can be used to transfer
  4450.           ASCII files for  greater  error  detection  capability.  Both the
  4451.           ASCII and XMODEM protocols are compatible with  computer bulletin
  4452.           board software such as RBBS or FIDO.
  4453.  
  4454.                   In  the descriptions which follow, the computer  referred
  4455.           to  as  the  host  is  assumed  to  be a VAX-11 running VMS.  All
  4456.           references  to an IBM PC filename include  a  drive  letter,  the
  4457.           path,  the  filename  and  the  file  extension,  for  example  -
  4458.           a:\usr\bin\file.ext. If no  drive  letter or path is given, PC-VT
  4459.           accesses  the  current  default  directory.  You  can  change the
  4460.           default drive and directory by  pressing  CTRL-F2.  See  the last
  4461.           section in this chapter for details.
  4462.  
  4463.                   The  file transfer mode can be set  when  you  enter  the
  4464.           filename to be transferred or it can be set in the SETUP B frame.
  4465.           In  that  frame,  press "x" until your desired mode is displayed.
  4466.           Then go  to  the  SETUP  A  frame  and  press  "s"  to  store the
  4467.           information into USER MEMORY on disk.
  4468.  
  4469.                   When you active any  of  the  functions described in this
  4470.           chapter from the VT emulator, PC-VT opens a window on  the screen
  4471.           in which the described interaction takes place. In  4014  mode, a
  4472.           window  is  not  opened but the interaction takes place as normal
  4473.           screen output.
  4474.  
  4475.  
  4476.           8.1  Transmitting ASCII Files (Uploading)
  4477.  
  4478.  
  4479.                   To transmit or upload an ASCII file to the host, the host
  4480.           must be  set  to  receive  the file and then PC-VT can be told to
  4481.           transmit it. The host  computer  can be told to execute a program
  4482.           which reads the terminal or more simply, you can use the VMS COPY
  4483.  
  4484.  
  4485.                                                                     Page 63
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.           Transmitting and Receiving Files                      PC-VT v10.0
  4493.  
  4494.  
  4495.           command.  Once  you  have started PC-VT and logged onto the host,
  4496.           you will see the "$" VMS command line  prompt.  You  use  the VMS
  4497.           COPY command as follows:
  4498.  
  4499.           COPY TT:  <filename>
  4500.  
  4501.           There must be space between the TT: and the filename.
  4502.  
  4503.           The  host  then  waits  for  characters to be transmitted by  the
  4504.           terminal. To request PC-VT to start uploading, press CTRL-F4. PC-
  4505.           VT prompts for the name  of  the  PC  file  to  upload.  Type the
  4506.           filename followed by "=a" and  then  press  ENTER.  Just pressing
  4507.           ENTER  cancels  the  transmit request. If PC-VT finds the file as
  4508.           specified, it transmits it to the host. If the file is not found,
  4509.           you will be prompted  again  for the filename. The "=a" option on
  4510.           the end of the filename indicates ASCII file transfer mode.
  4511.  
  4512.                   At  the end of the file, if you  have  selected  the  VMS
  4513.           operating system in  the  SETUP  frame,  PC-VT asks if you want a
  4514.           CTRL-Z  (ASCII  code  26) sent to the host. The CTRL-Z terminates
  4515.           the  VMS  COPY  command. An upper or lower case "y" must be typed
  4516.           followed by ENTER to send the CTRL-Z. If you  have  selected  the
  4517.           UNIX operating system and have done a CAT command, PC-VT  asks if
  4518.           you want a CTRL-D sent to the host.
  4519.  
  4520.                   PC-VT  normally  strips  all  Line Feed characters (ASCII
  4521.           code 10) before it transmits the file. All  other  characters are
  4522.           transmitted. If you have set Local Echo in the SETUP frame, PC-VT
  4523.           sends  the linefeed characters. This is the  only  case  when  it
  4524.           does. PC-VT detects  the  end  of  the  PC file by using the byte
  4525.           count in the directory entry for the file. PC-VT does not require
  4526.           that you have a CTRL-Z at the end of the PC file.
  4527.  
  4528.                   A very useful feature of  this routine is that it handles
  4529.           XOFF/XON characters received from the host during uploading. This
  4530.           prevents the host from losing data if it is busy. The  host sends
  4531.           an  XOFF  if  its buffer is filling.  PC-VT  automatically  stops
  4532.           transmitting until an XON  is  received  indicating that the host
  4533.           has emptied its buffer.  You  should be sure that this feature is
  4534.           enabled under your logon on the  VMS  system. To do this, use the
  4535.           VMS SET command as shown below:
  4536.  
  4537.           SET TERMINAL /HOSTSYNC
  4538.  
  4539.           This command should be put in your LOGIN.COM file unless your VMS
  4540.           system sets this feature as a default.
  4541.  
  4542.                   If  you  wish  to cancel the transmission  before  it  is
  4543.           complete, simply press CTRL-F4  at  any  time. PC-VT prompts with
  4544.           the CTRL-Z/CTRL-D message and then  terminate  the  upload. PC-VT
  4545.           ignores all other keys pressed during an upload.
  4546.  
  4547.                   If you don't request the transmission of a CTRL-Z/CTRL-D,
  4548.           you can press CTRL-F4  again  and send another file. The new file
  4549.  
  4550.  
  4551.           Page 64
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4559.  
  4560.  
  4561.           transmitted  will  be  read  by  the  same  COPY command  entered
  4562.           earlier. You can use this function to append many  files  to  one
  4563.           another as you transmit them.
  4564.  
  4565.                   In addition, in VMS mode,  the host can cancel the upload
  4566.           if it needs to. If the host sends a CTRL-Z (ASCII 26) while PC-VT
  4567.           is  doing an ASCII file upload,  PC-VT  immediately  cancels  the
  4568.           upload. In UNIX mode, the host  can  also cancel the upload if it
  4569.           needs to. If  the  host  sends  a  CTRL-D while PC-VT is doing an
  4570.           ASCII file upload, PC-VT immediately cancels the upload.
  4571.  
  4572.                   There are  several  messages  generated  by  PC-VT  while
  4573.           transmitting a file:
  4574.  
  4575.           "Current default directory is ":
  4576.                          The current default directory is displayed.
  4577.  
  4578.           "Drive d: xxxxxx  bytes free":
  4579.                          The number of  free  bytes on the default drive is
  4580.                          displayed.
  4581.  
  4582.           "Default File Transfer Mode is ASCII
  4583.           Enter Name of the PC File to Transmit
  4584.           [d:][path][filename[.ext]][={a,z,x,c,k,t,v}]
  4585.           (Press ENTER to cancel upload and return to emulator):":
  4586.  
  4587.  
  4588.                          PC-VT is asking for  the  name  of  the PC file to
  4589.                          transmit.  Type the filename in  the  standard DOS
  4590.                          format  and  press  ENTER.  Pressing   just  ENTER
  4591.                          cancels the transmitting routine.  If  you  do not
  4592.                          specify a  drive  or  path,    PC-VT  accesses the
  4593.                          default  directory.  The default directory can  be
  4594.                          changed with the CTRL-F2 command.    See  the last
  4595.                          section in this chapter for details.
  4596.  
  4597.                          The "=a" and  "=z"  options  start  up  ASCII file
  4598.                          transfer. The "=a" option uses the byte count from
  4599.                          the  disk  directory  to  set  the  length  of the
  4600.                          transferred  file. The  "=z"  option  ignores  the
  4601.                          length  and  stops  transmitting  when a CTRL-Z is
  4602.                          encountered in the file.
  4603.  
  4604.                          The "=x" and  "=c"  options  start  up  the XMODEM
  4605.                          protocol. The "=t"  option starts up file transfer
  4606.                          with handshaking. These are both explained below.
  4607.  
  4608.                          The "=k" option starts up the KERMIT file transfer
  4609.                          program.
  4610.  
  4611.                          The "=v" option lets  you  look  at  a file on the
  4612.                          screen. See a later  section  in  this  chapter to
  4613.                          view a file.
  4614.  
  4615.  
  4616.  
  4617.                                                                     Page 65
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.           Transmitting and Receiving Files                      PC-VT v10.0
  4625.  
  4626.  
  4627.                          PC-VT DEFAULTS to XMODEM protocol  if  you  do not
  4628.                          enter an  option  and  have  not  selected  a file
  4629.                          transfer mode in the SETUP  B  frame.  The current
  4630.                          default is displayed as a reminder.
  4631.  
  4632.           "Transmitting xxx bytes (yyy blocks)":
  4633.                          PC-VT calculates the size of the file and displays
  4634.                          the   number   of  bytes  (and   blocks)   to   be
  4635.                          transmitted. There are 128 bytes in a  block which
  4636.                          corresponds to the XMODEM block size.
  4637.  
  4638.           "Should a CTRL-Z be transmitted? (y or n) :":
  4639.                          If you have selected the VMS  operating  system in
  4640.                          the SETUP frame and PC-VT detects the end of file,
  4641.                          it does not  transmit  a CTRL-Z to the host unless
  4642.                          you  respond  positively to this  query.  Type  an
  4643.                          upper or  lower case "y" followed by ENTER and PC-
  4644.                          VT   transmits a CTRL-Z. If  you  type  any  other
  4645.                          character   or   just   ENTER,   CTRL-Z   is   not
  4646.                          transmitted. With  this  feature,  CTRL-F4  can be
  4647.                          activated  again  and  several  PC  files  can  be
  4648.                          concatenated into one host file.
  4649.  
  4650.           "Should a CTRL-D be transmitted? (y or n) :":
  4651.                          If you have selected the UNIX operating  system in
  4652.                          the SETUP frame and PC-VT detects the end of file,
  4653.                          it does not  transmit  a CTRL-D to the host unless
  4654.                          you  respond  positively to this  query.  Type  an
  4655.                          upper or  lower case "y" followed by ENTER and PC-
  4656.                          VT transmits  a  CTRL-D.  If  you  type  any other
  4657.                          character   or   just   ENTER,   CTRL-D   is   not
  4658.                          transmitted. With  this  feature,  CTRL-F4  can be
  4659.                          activated  again  and  several  PC  files  can  be
  4660.                          concatenated into one host file.
  4661.  
  4662.           "Transmission Complete":
  4663.                          File uploading is complete.
  4664.  
  4665.           "Transmission Canceled":
  4666.                          CTRL-F4  was  pressed  during a file transmission.
  4667.                          The uploading is immediately canceled.
  4668.  
  4669.           "Filename is not in correct format":
  4670.                          The  filename entered in response to the  filename
  4671.                          inquiry is not  a  valid DOS filename. You may re-
  4672.                          enter the filename.
  4673.  
  4674.           "File not found as specified":
  4675.                          PC-VT could not find  the  file  on  the specified
  4676.                          disk.  Usually  caused  by  either the wrong drive
  4677.                          letter, directory or  a mistyped filename. You may
  4678.                          re-enter the filename.
  4679.  
  4680.  
  4681.  
  4682.  
  4683.           Page 66
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4691.  
  4692.  
  4693.  
  4694.           8.1.1  Uploading with Handshake
  4695.  
  4696.                   If you append an "=t" on the end of the filename when you
  4697.           type itin, PC-VT uploads the ASCII file as described above except
  4698.           that the program waits for a turnaround character before it sends
  4699.           the next line. The  turnaround  character  is  set in the SETUP-A
  4700.           frame. This feature is useful if the host is not  buffered. PC-VT
  4701.           won't send any characters until the host has  processed  the last
  4702.           line transmitted and prompts for  another  line.  This turnaround
  4703.           character is sometimes  called  a bypass character. For a typical
  4704.           VAX system you may want to set this to a linefeed (ASCII 10) or a
  4705.           dollar sign (ASCII 36)  which  is the default value for PC-VT. In
  4706.           addition,  a  CTRL-Z/CTRL-D  is not transmitted at the end of the
  4707.           file.  This upload as well as the regular  ASCII  upload  can  be
  4708.           canceled by pressing CTRL-F4.
  4709.  
  4710.                   Pressing  the  space  bar  overrides  the  wait  for  the
  4711.           turnaround character. If the turnaround  character  is  missed or
  4712.           lost,  PC-VT  waits  forever. By pressing the space bar, you tell
  4713.           PC-VT to send the next line of the  file.  PC-VT  sends  the next
  4714.           line and waits again. Other keys are ignored while the  upload is
  4715.           in progress. (This lets you  set the turnaround character to some
  4716.           totally unused code and use the space bar to transmit one line at
  4717.           a time to the host.)
  4718.  
  4719.                   Operation is as follows: initiate the upload  by pressing
  4720.           CTRL-F4. Give PC-VT the  filename  with  the "=t" appended. PC-VT
  4721.           sends the first line of the  file  up to a carriage return (ASCII
  4722.           13).  PC-VT  then  waits  until  the  host  sends the  turnaround
  4723.           character. PC-VT then sends the next line of  the  file  up  to a
  4724.           carriage return and so  on.  Following the last line of the file,
  4725.           the keyboard is enabled again for you to type to the host.
  4726.  
  4727.                   Three dynamic features make this easier to use:
  4728.  
  4729.                 The turnaround character can be changed in the middle of an
  4730.                 uploaded file. To do  this,  as  you  are creating the file
  4731.                 enter  an  ASCII  1  into  the  file  followed by  the  new
  4732.                 turnaround character. The ASCII 1 (a CTRL-A)  signals PC-VT
  4733.                 that the next character read from the file is be to  set as
  4734.                 the new turnaround  character.  Neither the ASCII 1 nor the
  4735.                 new  turnaround character is sent to  the  host.  This  new
  4736.                 turnaround character  is visible in the SETUP A frame. This
  4737.                 does mean that you  cannot  have an ASCII 1 in any uploaded
  4738.                 text handshake file, but that should not be a problem since
  4739.                 ASCII 1 is rarely used in a text file.
  4740.  
  4741.                 An ASCII 2 (a CTRL-B) in the file signals PC-VT to wait for
  4742.                 1 second before proceeding to the next character. This is a
  4743.                 "pause" feature. You  can  have as many of these characters
  4744.                 in  a row as you like to make up longer pauses. The ASCII 2
  4745.                 is not sent to the host. This also means  that  you  cannot
  4746.                 have an ASCII 2 in any upload text handshake file, but that
  4747.  
  4748.  
  4749.                                                                     Page 67
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.           Transmitting and Receiving Files                      PC-VT v10.0
  4757.  
  4758.  
  4759.                 should not be a problem since  ASCII  2 is rarely used in a
  4760.                 text file.
  4761.  
  4762.                 An ASCII 20 (a  CTRL-T)  in the file signals PC-VT that the
  4763.                 next character in the file is a binary value specifying the
  4764.                 number  of  seconds  to  wait  after  the  receipt  of  the
  4765.                 turnaround character before PC-VT sends the next  line. For
  4766.                 example, to have PC-VT wait for 5 seconds before responding
  4767.                 to each  turnaround character, enter a CTRL-T followed by a
  4768.                 CTRL-E (ASCII 5) into the file. Once this value is  set, it
  4769.                 remains set until you terminate PC-VT or you set it to some
  4770.                 other value. Remember,  it  waits after the receipt of each
  4771.                 turnaround character. Default value is zero seconds.
  4772.  
  4773.                   Scanning for these  three special control characters only
  4774.           takes place if you started the upload with the  "=t"  option.  If
  4775.           you started a  regular  upload (the "=a" option) these characters
  4776.           are uploaded just like all  others and the handshake is disabled.
  4777.           If, while you are setting up  your  files, you make a mistake and
  4778.           PC-VT is waiting  for  a turnaround character which never occurs,
  4779.           just press CTRL-F4 and PC-VT  returns  to  normal  keyboard input
  4780.           mode.
  4781.  
  4782.  
  4783.           8.1.2  Example of a Transmission Session
  4784.  
  4785.  
  4786.                   This  is  typical  of what you  would  see  and  type  to
  4787.           transmit a file to the host.
  4788.  
  4789.           $ copy tt: up.fil
  4790.           Press the CTRL-F4 key
  4791.           Current default directory is
  4792.           a:\usr\me\pcvt
  4793.           Drive a: 3435423 bytes free
  4794.           Default File Transfer Mode is ASCII
  4795.           Enter Name of the PC File to Transmit
  4796.           [d:][path][filename[.ext]][={a,z,x,c,k,t,v}]
  4797.           (Press ENTER to cancel upload and return to emulator)
  4798.           b:\mydire\pc.asc=a
  4799.           Transmitting 3543 bytes (28 blocks)
  4800.           Now the PC file named b:\mydire\pc.asc is transmitted,
  4801.           the file is displayed on the screen as it is
  4802.           echoed back from the host.
  4803.           Should a CTRL-Z be transmitted? (y or n) : y
  4804.           A CTRL-Z is sent to the host.
  4805.           Transmission complete
  4806.           ^Z
  4807.           The host file named up.fil is closed. The host COPY
  4808.           command is terminated.
  4809.           $
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.           Page 68
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4823.  
  4824.  
  4825.  
  4826.           8.1.3  A Useful VAX .COM Upload File
  4827.  
  4828.  
  4829.                   This simplified  upload facility uploads a file from a PC
  4830.           disk file to a VAX system running VMS.
  4831.  
  4832.                   Create  a  file  on  the  VAX  system   named  "pcup.com"
  4833.           consisting of the following commands:
  4834.  
  4835.           $ on error then goto err1
  4836.           $ on control_y then goto ctrl
  4837.           $ if p1.eqs."" then inquire p1 "Enter Name of VAX File to " -
  4838.           $       "Contain Uploaded Data"
  4839.           $ if p1 .eqs. "" then goto ctrl
  4840.           $ set term/nobroad
  4841.           $ write sys$output "<ESC>[?22h"
  4842.           $ copy tt:  'p1'
  4843.           $ exit:
  4844.           $ set term/broad
  4845.           $ exit
  4846.           $ err1:
  4847.           $ write sys$output "A VAX error has occurred. Please try again."
  4848.           $ ctrl:
  4849.           $ write sys$output "Upload Canceled."
  4850.           $ goto exit
  4851.  
  4852.                   The symbol <ESC> is the  ESCAPE character 27. You have to
  4853.           use your host's text editor to replace the <ESC>  with  the  real
  4854.           ESCAPE character.
  4855.  
  4856.                   Once you have started PC-VT on the PC and you have logged
  4857.           onto a VAX, upload files from the PC to the VAX by:
  4858.  
  4859.             1.  Type this in response to the "$" VMS prompt:
  4860.  
  4861.                 @pcup <filename>
  4862.  
  4863.             2.  If you did not enter the filename on the command  line, the
  4864.                 facility asks you for the name of the VAX  file  which  you
  4865.                 wish to create with the  uploaded  data  (include directory
  4866.                 information if needed)
  4867.  
  4868.                 dra1:[user1.dire.lev2]z.com
  4869.  
  4870.             3.  If you just press ENTER, the upload is canceled.
  4871.  
  4872.             4.  The facility asks you for the name of the PC file which you
  4873.                 wish to upload (include disk drive letter if needed)
  4874.  
  4875.                 zzzzz.com=a
  4876.  
  4877.             5.  If you just press ENTER, the upload is canceled.
  4878.  
  4879.  
  4880.  
  4881.                                                                     Page 69
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.           Transmitting and Receiving Files                      PC-VT v10.0
  4889.  
  4890.  
  4891.             6.  The rest is automatic. The data displays on the PC's screen
  4892.                 as it is echoed. The upload is complete when  the  "$"  VMS
  4893.                 prompt appears.
  4894.  
  4895.             7.  To abort the upload before it is complete, press:
  4896.  
  4897.                 CTRL-F4
  4898.  
  4899.             8.  The VAX file contains whatever  data  was  uploaded  to the
  4900.                 point where you aborted the  upload. You may see some extra
  4901.                 characters  displayed  on  the  screen,  this  is  just the
  4902.                 communications buffer emptying.
  4903.  
  4904.                   The  ESC [ ? 22 h sequence is  a  special  PC-VT  private
  4905.           sequence described in Appendix J.
  4906.  
  4907.  
  4908.           8.2  Transmitting Binary Files (Uploading)
  4909.  
  4910.  
  4911.                   PC-VT supports the XMODEM protocol  for  binary  or ASCII
  4912.           file  transfer.  Support  is  included  for  both  checksum error
  4913.           checking compatible with  RBBS  and  for  Cyclic  Redundancy Code
  4914.           (CRC) error checking.  This  transfer mode requires that the host
  4915.           computer be capable of handling this protocol.
  4916.  
  4917.                   To run XMODEM, start up  the host XMODEM program and then
  4918.           follow the instructions for transmitting ASCII files  but include
  4919.           "=x" after the filename("=c"  is  equivalent  for  transmit). The
  4920.           XMODEM module is automatically started and the  transfer proceeds
  4921.           without further intervention. The transfer is started in checksum
  4922.           mode; the receiver has the option of switching to CRC mode. PC-VT
  4923.           clicks the speaker with each block transmitted.
  4924.  
  4925.                   PC-VT automatically changes  the communications to 8 data
  4926.           bits, no parity, 1 stop bit (8-N-1) if you are not already set at
  4927.           that protocol. PC-VT then restores the protocol to your set value
  4928.           when the XMODEM transfer is complete.
  4929.  
  4930.                   To cancel  the transfer while it is progress, press CTRL-
  4931.           X. This may require a few seconds to take  effect  because  PC-VT
  4932.           must gracefully terminate the protocol.
  4933.  
  4934.                   Refer to  already  published  texts  for  details  on the
  4935.           XMODEM protocol.
  4936.  
  4937.  
  4938.           8.3  Receiving ASCII Files (Downloading)
  4939.  
  4940.  
  4941.                   To receive an ASCII  file,  PC-VT  must  be told to start
  4942.           receiving and then the host must be told to transmit. To activate
  4943.           Receive File, press CTRL-F3. This can be done at any time  in the
  4944.           communications frame. PC-VT asks for  the  filename  on  which to
  4945.  
  4946.  
  4947.           Page 70
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.           PC-VT v10.0                                 VT100 & 4014 Emulator
  4955.  
  4956.  
  4957.           write the received  characters.  Type in the filename followed by
  4958.           either  "=a"  or  "=A"  followed  by ENTER. Just  pressing  ENTER
  4959.           terminates the receive request. If the file already exists, PC-VT
  4960.           asks if you wish to overwrite it. If  you  type  "y"  followed by
  4961.           ENTER, PC-VT deletes the old file and starts to create another.
  4962.  
  4963.                   You  can  now  tell the host to type out a file and PC-VT
  4964.           writes  it  onto  the IBM PC disk. At the VMS dollar sign prompt,
  4965.           enter this command:
  4966.  
  4967.           TYPE <filename>
  4968.  
  4969.                   The option following the filename  tells  PC-VT  that you
  4970.           want to do an ASCII download. If you  use  the  "=A"  option, ALL
  4971.           further characters received from the  host except 00H and 7FH are
  4972.           written onto the disk file.
  4973.  
  4974.                   If You use the "=a" option, PC-VT waits until it receives
  4975.           a Line  Feed character, then ALL further characters received from
  4976.           the host except 00H and 7FH are written onto the disk file. PC-VT
  4977.           doesn't write out data to disk until a linefeed  is  received  in
  4978.           order  to  let  you to enter the VMS TYPE command.  This prevents
  4979.           the TYPE command from being written to the file.
  4980.  
  4981.                   To  terminate  Receive  File,  press CTRL-F3 again. PC-VT
  4982.           closes the disk file and resumes normal operation.
  4983.  
  4984.                   This mode is  also  called File Capture Mode. Since PC-VT
  4985.           cannot  tell   the  difference  between  a  file  and  any  other
  4986.           characters sent by the  host,  all  characters  (except - 00H and
  4987.           7FH)  received  go  onto  the  disk  file.  This includes  ESCAPE
  4988.           sequences and all VMS command language interaction. This can be a
  4989.           useful  feature  if  you  are  programming  with  some  of  these
  4990.           sequences  and  your  program  is  not  working  correctly. PC-VT
  4991.           preserves these  characters on disk for your inspection. Once the
  4992.           file  is  closed,  you must exit PC-VT and enter a text editor to
  4993.           strip off any unwanted characters from the file.
  4994.  
  4995.                   PC-VT puts an  End  of  File  indicator at the end of the
  4996.           disk file  before  it  closes  the file. For the IBM PC this is a
  4997.           CTRL-Z  character  (ASCII  code  26).  As  a  reminder, "RCV"  is
  4998.           displayed  on  the  Status Line while Receive File is active. The
  4999.           receipt  of  a  CTRL-Z in VMS mode  or  a  CTRL-D  in  UNIX  mode
  5000.           terminates  Receive File and closes the  received  file.  If  you
  5001.           terminate  PC-VT,  the  received  file  is closed as if a  CTRL-Z
  5002.           character was received.
  5003.  
  5004.                   Receive File terminates if it  runs out of disk space for
  5005.           the  downloaded  file.  The  last  block (up to  512  characters)
  5006.           received  is  lost  and no CTRL-Z  (End  of  File)  indicator  is
  5007.           written. The file, however, is closed.
  5008.  
  5009.                   There are  several  messages  generated  by  PC-VT  while
  5010.           receiving a file:
  5011.  
  5012.  
  5013.                                                                     Page 71
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.           Transmitting and Receiving Files                      PC-VT v10.0
  5021.  
  5022.  
  5023.           "Current default directory is ":
  5024.                          The current default directory is displayed.
  5025.  
  5026.           "Drive d: xxxxxx  bytes free":
  5027.                          The number of  free  bytes on the default drive is
  5028.                          displayed.
  5029.  
  5030.           "Default File Transfer Mode is ASCII
  5031.           Enter Name of the PC File to Receive
  5032.           [d:][path][filename[.ext]][={a,A,x,c,k}]
  5033.           (Press ENTER to cancel download and return to emulator):":
  5034.  
  5035.                          PC-VT is asking for  the  name  of  the PC file to
  5036.                          receive.  Type  the  filename  in the standard DOS
  5037.                          format  and  press  ENTER.  Pressing   just  ENTER
  5038.                          cancels the  receiving  routine.  If  you  do  not
  5039.                          specify  a  drive  or  path,  PC-VT  accesses  the
  5040.                          default  directory.  The  default directory can be
  5041.                          changed  with  the  CTRL-F2  command. See the last
  5042.                          section in this chapter for details.
  5043.  
  5044.                          The "=a" and  "=A"  options  start  up  ASCII file
  5045.                          transfer. The "=a" option waits  for  a  line feed
  5046.                          character, the other option does not.
  5047.  
  5048.                          The "=x" and  "=c"  options  start  up  the XMODEM
  5049.                          protocol.
  5050.  
  5051.                          The "=k" option starts up the KERMIT file transfer
  5052.                          program.
  5053.  
  5054.                          If you do  not  specify  a  option,  PC-VT assumes
  5055.                          XMODEM  protocol. The  currently  set  default  is
  5056.                          displayed as  a reminder. It can be changed in the
  5057.                          SETUP B frame.
  5058.  
  5059.           "Filename is not in correct format":
  5060.                          The  filename entered in response to the  filename
  5061.                          inquiry is not in the standard DOS format. You may
  5062.                          re-enter the filename.
  5063.  
  5064.           "Insert   diskette   with   received   file.   Press   ENTER   to
  5065.           continue....":
  5066.                          PC-VT found a different diskette in the disk drive
  5067.                          than  the one it  opened  the  download  file  on.
  5068.                          Replace  the  original  diskette  in the drive and
  5069.                          press the ENTER key. Pressing  any  other  key and
  5070.                          then pressing ENTER terminates the  file transfer.
  5071.                          The data on the diskette  may  not  be  correct or
  5072.                          complete.
  5073.  
  5074.           "File already exists. Do you want to overwrite it? (y or n)":
  5075.                          The filename which  you entered already exists. If
  5076.                          you  respond  with  a  lower  or  upper  case  "Y"
  5077.  
  5078.  
  5079.           Page 72
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5087.  
  5088.  
  5089.                          followed by the ENTER key, PC-VT deletes  the file
  5090.                          and  creates a new one with  the  same  name.  Any
  5091.                          other response preserves the file and receive file
  5092.                          is canceled.
  5093.  
  5094.           "File is being overwritten":
  5095.                          PC-VT confirms that the old file has  been deleted
  5096.                          and a new file is being created.
  5097.  
  5098.           "Invalid path/filename or directory full. Receive terminated":
  5099.                          PC-VT  could  not  create  the  file  because  the
  5100.                          directory on the  specified diskette was full, the
  5101.                          file  was  marked  read-only, or the path/filename
  5102.                          specified is invalid.
  5103.  
  5104.           "Disk full. Receive terminated":
  5105.                          PC-VT  ran  out  of space on the  disk.  The  file
  5106.                          already written is closed. A CTRL-Z is  not placed
  5107.                          at the end of the file. The last block (up  to 512
  5108.                          characters) received is lost.
  5109.  
  5110.  
  5111.           8.3.1  Example of a Receive Session
  5112.  
  5113.  
  5114.                   This is typical of what you would see and type to receive
  5115.           a file from the host. Comments are underlined.
  5116.  
  5117.           $
  5118.           Press the CTRL-F3 key
  5119.           Current default directory is
  5120.           a:
  5121.           Drive a: 32234  bytes free
  5122.           Default File Transfer Mode is ASCII
  5123.           Enter Name of the PC File to Receive
  5124.           [d:][path][filename[.ext]][={a,A,x,c,k}]
  5125.           (Press ENTER to cancel download and return to emulator)
  5126.           b:receive.txt=a
  5127.           RCV is displayed on the Status Line and any characters
  5128.           sent by the host are copied to the PC disk file.
  5129.           type host.dat
  5130.           The host file named host.dat is received by PC-VT
  5131.           and placed on the PC disk file named b:receive.txt.
  5132.           $
  5133.           Press the CTRL-F3 key
  5134.           The file is closed and RCV is cleared from the Status
  5135.           Line.
  5136.  
  5137.  
  5138.           8.3.2  A Useful VAX .COM Download File
  5139.  
  5140.  
  5141.                   This simplified Download facility downloads a file from a
  5142.           VAX system running VMS to a  PC  disk  file. Create a file on the
  5143.  
  5144.  
  5145.                                                                     Page 73
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.           Transmitting and Receiving Files                      PC-VT v10.0
  5153.  
  5154.  
  5155.           VAX  system  named   "pcdown.com"  consisting  of  the  following
  5156.           commands:
  5157.  
  5158.           $ on error then goto err2
  5159.           $ on control_y then goto ctrl
  5160.           $ if p1.eqs."" then inquire p1 "Enter Name of VAX File to
  5161.           Download"
  5162.           $ if p1 .eqs. "" then goto ctrl
  5163.           $ open for008 'p1'/error=err1
  5164.           $ close for008
  5165.           $ set term/nobroad
  5166.           $ write sys$output "<ESC>[?21h"
  5167.           $ copy 'p1' tt:
  5168.           $ write sys$output "^Z"
  5169.           $ exit:
  5170.           $ set term/broad
  5171.           $ exit
  5172.           $ err1:
  5173.           $ write sys$output "VAX File Not Found."
  5174.           $ ctrl:
  5175.           $ write sys$output "Download Canceled."
  5176.           $ goto exit
  5177.           $ err2:
  5178.           $ write sys$output "A VAX error has occurred, Please try again."
  5179.           $ goto ctrl
  5180.  
  5181.                   The symbol <ESC>  is  the ESCAPE character 27. The symbol
  5182.           ^Z is the CTRL-Z character 26.  You  have to use your host's text
  5183.           editor  to  replace  the <ESC> with the real ESCAPE character and
  5184.           the ^Z with a real CTRL-Z character.
  5185.  
  5186.                   Once you have started PC-VT on the PC and you have logged
  5187.           onto a VAX, download files from the VAX to the PC by:
  5188.  
  5189.             1.  Type this in response to the "$" VMS prompt:
  5190.  
  5191.                 @pcdown <filename>
  5192.  
  5193.             2.  If you did not enter the filename on the command  line, the
  5194.                 facility asks you for the name of the VAX  file  which  you
  5195.                 wish to download (include directory information if needed)
  5196.  
  5197.                 [upload]xmit.com
  5198.  
  5199.             3.  If you just press ENTER, the download is canceled.
  5200.  
  5201.             4.  The facility asks you for the name of the PC file which you
  5202.                 wish to create with the downloaded data (include disk drive
  5203.                 letter if needed)
  5204.  
  5205.                 a:pcfile.dat=a
  5206.  
  5207.             5.  If you just press ENTER, the download is  canceled.  If the
  5208.                 name you give for the PC file already exists, PC-VT asks if
  5209.  
  5210.  
  5211.           Page 74
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5219.  
  5220.  
  5221.                 you want to overwrite the file. If you answer "y",  all the
  5222.                 new data  replaces  the  old  data  on  the PC file. If you
  5223.                 answer "n" or just press ENTER, the download is canceled.
  5224.  
  5225.             6.  The rest is automatic. The data displays on the PC's screen
  5226.                 while it is being downloaded. The download is complete when
  5227.                 the "$" VMS prompt appears.
  5228.  
  5229.             7.  To abort the download before it is complete, press:
  5230.  
  5231.                 CTRL-F3
  5232.  
  5233.             8.  The PC file contains  whatever  data  was downloaded to the
  5234.                 point  where you aborted the download.  You  may  see  some
  5235.                 extra output on the screen; this is just the communications
  5236.                 buffer emptying.
  5237.  
  5238.                   The  ESC [ ? 21 h sequence is  a  special  PC-VT  private
  5239.           sequence described in Appendix J.
  5240.  
  5241.  
  5242.           8.4  Receiving Binary Files (Downloading)
  5243.  
  5244.  
  5245.                   PC-VT supports the XMODEM protocol  for  binary  or ASCII
  5246.           file  transfer.  Support  is  included  for  both  checksum error
  5247.           checking compatible with bulletin  boards  such  as RBBS and FIDO
  5248.           and for Cyclic Redundancy Code(CRC) error checking. This transfer
  5249.           mode requires that the host  computer be capable of handling this
  5250.           protocol.
  5251.  
  5252.                   To run XMODEM, start up  the host XMODEM program and then
  5253.           follow the instructions for  receiving  ASCII  files  but include
  5254.           "=x" after the filename  for  checksum mode or "=c" for CRC mode.
  5255.           The XMODEM  module  is  automatically  started  and  the transfer
  5256.           proceeds  without  further   intervention.  Since  PC-VT  is  the
  5257.           receiver, you have the option  of  selecting  the  error checking
  5258.           mode. Checksum mode detects all burst errors of less than  8 bits
  5259.           in length and 99.6% of all  burst  errors longer than 8 bits. CRC
  5260.           mode detects all single and double bit errors, all errors with an
  5261.           odd number of bits, all burst errors of  length  16  or  less and
  5262.           99.997% of all 17 bit and longer bursts. The CRC supported is the
  5263.           CCITT recommended x^16 + x^12 + x^5 + 1.
  5264.  
  5265.                   PC-VT automatically changes  the communications to 8 data
  5266.           bits, no parity, 1 stop bit (8-N-1) if you are not already set at
  5267.           that protocol. PC-VT restores the protocol to your set value when
  5268.           the XMODEM transfer is  complete.  PC-VT  clicks the speaker with
  5269.           each block received.
  5270.  
  5271.                   To cancel  the transfer while it is progress, press CTRL-
  5272.           X. This may require a few seconds to take  effect  because  PC-VT
  5273.           must gracefully terminate the protocol. PC-VT does not delete the
  5274.  
  5275.  
  5276.  
  5277.                                                                     Page 75
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.           Transmitting and Receiving Files                      PC-VT v10.0
  5285.  
  5286.  
  5287.           partial file already created on disk but closes it and  leaves it
  5288.           for you to examine and delete.
  5289.  
  5290.                   Refer to  already  published  texts  for  details  on the
  5291.           XMODEM protocol.
  5292.  
  5293.  
  5294.           8.5  Viewing Files
  5295.  
  5296.  
  5297.                   PC-VT lets you view files on the display  when  you press
  5298.           the CTRL-F4 (Transmit a file) key. Use the option "=v" at the end
  5299.           of the filename. PC-VT displays the file on the screen.
  5300.  
  5301.                   The  viewing  is  in the context of the emulator which is
  5302.           running. That is, if  the  VT100  emulator  is active, any Escape
  5303.           sequences read from the file are acted upon. The same is  true if
  5304.           the VT52 or 4014 emulator is running.
  5305.  
  5306.                   For example, you can use Receive file with "=A" option to
  5307.           capture a session with your  host computer. The Receive file with
  5308.           "=A" option  saves all received characters in the disk, including
  5309.           all  escape  sequences.  With the "=v" option, you can review the
  5310.           session  later  and  see the same cursor movement and full screen
  5311.           editing features as when you were on line to the host computer.
  5312.  
  5313.                   As  described  in  Chapter 5, you can use this feature to
  5314.           redefine any of PC-VT's extended function and editing keys.
  5315.  
  5316.                   An even more useful feature is to use the "=A"  option on
  5317.           Receive file to capture a 4014 plot for later playback.  Just use
  5318.           Transmit file with the "=v" option while in the 4014 emulator and
  5319.           you will see the plot again.
  5320.  
  5321.  
  5322.           8.6  KERMIT File Transfer
  5323.  
  5324.  
  5325.                   PC-VT supports the official release of KERMIT.  To access
  5326.           this  feature  press  ALT-K  from  the  communications  frame.  A
  5327.           supplement to this document is a reprint of a KERMIT  manual from
  5328.           Columbia University. That manual is a complete description of how
  5329.           to use KERMIT and is supplied at no charge. Of course,  your host
  5330.           computer must have its version of KERMIT running.
  5331.  
  5332.                   CTRL-F3 and CTRL-F4 let you  go  directly  to  KERMIT for
  5333.           receiving or transmitting one file at a time. When you  enter the
  5334.           filename  prompted for, put an "=k"  after  the  filename.  PC-VT
  5335.           constructs the necessary  commands  for KERMIT and then starts up
  5336.           the program. When  KERMIT  is finished transferring the file, the
  5337.           PC-VT communications frame is automatically restarted.
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.           Page 76
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5351.  
  5352.  
  5353.           8.7  Changing the Default Directory
  5354.  
  5355.  
  5356.                   PC-VT supports  path  names  for  ASCII  and  XMODEM file
  5357.           transfers. PC-VT accesses  the  default drive and path unless you
  5358.           explicitly  enter  them.  You can change the  default  values  by
  5359.           pressing CTRL-F2 from the  communications  frame.  PC-VT displays
  5360.           the  current  default,  ask for the new default, and then display
  5361.           the complete new default path.  The input to this command follows
  5362.           the syntax for the CHDIR command to DOS. The amount of free space
  5363.           on the default drive is also displayed.
  5364.  
  5365.                   Here is what you would see and type:
  5366.  
  5367.           Current default directory is
  5368.           c:\level1
  5369.           Drive c: 34543  bytes free
  5370.           Enter new default directory
  5371.           [[d:][\][dirname][\dirname[...]]]
  5372.           level2
  5373.           Default directory is now
  5374.           c:\level1\level2
  5375.           Drive c: 34543  bytes free
  5376.  
  5377.                   When you type in  the  new  directory,  you can enter the
  5378.           change just as you would enter a change to the CHDIR command:
  5379.  
  5380.              -   a drive letter followed by a ":" changes  the  drive  only
  5381.                 (since DOS remembers the  path  associated  with  each disk
  5382.                 drive, the default directory  is  set  to whatever path had
  5383.                 been active on the specified drive), e.g. c:
  5384.  
  5385.              -  a path name starting at the root, e.g. c:\mydir\nextdir
  5386.  
  5387.              -  the root, e.g. f:\
  5388.  
  5389.              -  a directory name starting at  the  current  directory, e.g.
  5390.                 nextdir
  5391.  
  5392.  
  5393.           Error Message
  5394.  
  5395.  
  5396.           "Invalid directory entered - not changed":
  5397.                          You entered an invalid  disk  or  directory. PC-VT
  5398.                          did not change the default setting.
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.                                                                     Page 77
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.           Transmitting and Receiving Files                      PC-VT v10.0
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.           Page 78
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.                                       Chapter 9
  5492.  
  5493.                                     DIALING Frame
  5494.  
  5495.  
  5496.                   The DIALING frame is accessed  by  pressing  CTRL-F9 from
  5497.           the VT100 communications frame. The content of the communications
  5498.           frame is preserved and restored when you exit the DIALING frame.
  5499.  
  5500.  
  5501.           9.1  Dialing Instructions
  5502.  
  5503.  
  5504.  
  5505.  
  5506.                   The DIALING  frame  handles  Hayes  or  Hayes  compatible
  5507.           modems. The frame can hold 10 host names and phone  numbers. Each
  5508.           entry is broken into two fields. A name can be typed in columns 1
  5509.           to 20. This is for your information only. PC-VT does not use this
  5510.           information but it  is  stored  on  the  disk  file.  The dialing
  5511.           commands and phone number can be stored in columns 21 to  70. The
  5512.           "!" above column 21 is to remind you that,  when  dialing,  PC-VT
  5513.           sends  the data in columns 21 thru 70 to the modem as the dialing
  5514.           command.
  5515.  
  5516.                   Each  time  that  you save the DIALING frame using the F4
  5517.           key (see below),  PC-VT  saves the complete SETUP information for
  5518.           the host pointed to by the cursor. Then when you later  dial that
  5519.           host using the F1 key, PC-VT restores the SETUP information. This
  5520.           permits you to save  unique  SETUP information for each of the 10
  5521.           hosts. Be certain though, that when you press F4, that the cursor
  5522.           is on the line of the host in which you are interested.
  5523.  
  5524.                   When PC-VT starts up, it looks for a dialing directory on
  5525.           the default drive or the drive and directory pointed  to  by  the
  5526.           environment  string  'PC-VT='.  If it does not  find  one,  PC-VT
  5527.           creates a blank directory. The  name field is filled with dashes.
  5528.           The command field contains "ATDT" in the first  four  columns and
  5529.           is then filled with spaces. The SETUP information associated with
  5530.           each host is set to the default values.
  5531.  
  5532.                   The first thing that you need to do is enter the  name of
  5533.           the number's owner. You  can  use the cursor keys, the Enter key,
  5534.           the  Tab key, the Home key and the End key to position the cursor
  5535.           to any line. The "Ins" key inserts a space at the cursor position
  5536.           and the "Del" key  deletes  a  character  at the cursor position.
  5537.           Move the cursor to column 1 and type in the  name.  It should not
  5538.           go past column  20.    Then  to  enter the phone number, move the
  5539.  
  5540.  
  5541.                                                                     Page 79
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.           DIALING Frame                                         PC-VT v10.0
  5549.  
  5550.  
  5551.           cursor to column 24 using the TAB key and type in the number. The
  5552.           new directory can be saved by pressing the F4 key. The number can
  5553.           be dialed by pressing the F1 key.
  5554.  
  5555.                   Pressing any key while the dialer is running causes PC-VT
  5556.           to stop dialing and return to the communications frame.
  5557.  
  5558.                   Here is how each cursor  control  key  functions  in this
  5559.           frame:
  5560.  
  5561.           Left arrow :   moves the cursor one  column  to  the left. If the
  5562.                          cursor is  already in column 1, PC-VT beeps and no
  5563.                          action is taken. Use this key for a backspace then
  5564.                          enter a space to clear any character that may have
  5565.                          been mistyped.
  5566.  
  5567.           Right arrow :  moves the cursor  one  column to the right. If the
  5568.                          cursor is already in column 70, PC-VT beeps and no
  5569.                          action is taken.
  5570.  
  5571.           Up arrow :     moves  the cursor up one row.  If  the  cursor  is
  5572.                          already in the top  row  of  the  directory, PC-VT
  5573.                          beeps and no action is taken.
  5574.  
  5575.           Down arrow :   moves the cursor down  one  row.  If the cursor is
  5576.                          already in the bottom row of the  directory, PC-VT
  5577.                          beeps and no action is taken.
  5578.  
  5579.           Home :         moves the cursor to column 1 of the top row of the
  5580.                          directory.
  5581.  
  5582.           End :          moves the cursor to column  1 of the bottom row of
  5583.                          the directory.
  5584.  
  5585.           Enter :        moves  the  cursor  to column 1 of the next row of
  5586.                          the directory. If the  cursor  is  already  in the
  5587.                          bottom row of the directory, the  cursor  is moved
  5588.                          to column 1 of that row and PC-VT beeps.
  5589.  
  5590.           Tab :          moves the cursor to column 24 of the current row.
  5591.  
  5592.           Ins :          inserts a space at the cursor  position.  This key
  5593.                          operates  within either the name field (columns  1
  5594.                          thru 20) or the number field (columns 21 thru 70).
  5595.                          All characters from the  cursor  to  right  of the
  5596.                          field are moved one column to the  right. Anything
  5597.                          in the rightmost  column  of the field is lost. If
  5598.                          you press Ins within the  name  field,  the number
  5599.                          field is not affected.
  5600.  
  5601.           Del :          deletes  a character at the cursor position.  This
  5602.                          key operates within either the name field (columns
  5603.                          1 thru 20) or  the  number  field (columns 21 thru
  5604.                          70). All characters from the right  of  the cursor
  5605.  
  5606.  
  5607.           Page 80
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5615.  
  5616.  
  5617.                          to the rightmost column of the field are moved one
  5618.                          column to the  left.  A space is inserted into the
  5619.                          rightmost column of the field.  If  you  press Del
  5620.                          within the name field,  the  number  field  is not
  5621.                          affected.
  5622.  
  5623.                   In addition,  as a simple macro style logon facility, PC-
  5624.           VT does a little more work. If you enter the  tilde  key (the ~),
  5625.           PC-VT translates that into a carriage return (ASCII 13) when sent
  5626.           to  the modem. This permits you to send  multiple  lines  to  the
  5627.           modem. PC-VT translates  the  underscore,  '_',  into  the Escape
  5628.           character (ASCII 27).
  5629.  
  5630.                   PC-VT interprets several control characters in the dialer
  5631.           command line as special commands:
  5632.  
  5633.  
  5634.           CTRL-W :       causes  the  dialer   to  wait  5  seconds  before
  5635.                          continuing with the command. CTRL-W appears in the
  5636.                          directory as an underlined up-down arrow.
  5637.  
  5638.           CTRL-B :       causes   the  dialer  to  wait  1  second   before
  5639.                          continuing with the command. CTRL-B appears in the
  5640.                          directory as a Happy Face.
  5641.  
  5642.           CTRL-X :       stops the dialing at that  point  in  the command.
  5643.                          PC-VT  then,  as  usual,  sends its final carriage
  5644.                          return  to  the   modem.  CTRL-X  appears  in  the
  5645.                          directory as an up-arrow.
  5646.  
  5647.           CTRL-D :       causes the dialer to wait for  the  Carrier Detect
  5648.                          signal from the modem  before  continuing  to send
  5649.                          the dialer command. While  PC-VT  is  waiting, you
  5650.                          can  press  any  key and PC-VT goes on to the next
  5651.                          character in the command.  CTRL-D  appears  in the
  5652.                          directory as a diamond. Some modems require you to
  5653.                          set a  special  switch  in  the  modem  itself for
  5654.                          Carrier  Detect  to  operate correctly. Check your
  5655.                          modem manual.
  5656.  
  5657.           CTRL-F :       causes the dialer  to  wait for the Data Set Ready
  5658.                          signal from the modem  before  continuing  to send
  5659.                          the dialer command. While  PC-VT  is  waiting, you
  5660.                          can  press  any  key and PC-VT goes on to the next
  5661.                          character in the command.  CTRL-F  appears  in the
  5662.                          directory as a spade.
  5663.  
  5664.           CTRL-Q :       quotes the  next  character.  That  is,  the  next
  5665.                          character in the command  is  sent  to the host no
  5666.                          matter what it is.  This  is  used  if you need to
  5667.                          send one of the  control  characters  described in
  5668.                          this  section  which  PC-VT  normally  uses  as  a
  5669.                          special command.
  5670.  
  5671.  
  5672.  
  5673.                                                                     Page 81
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.           DIALING Frame                                         PC-VT v10.0
  5681.  
  5682.  
  5683.           CTRL-V :       causes the  dialer to send a BREAK signal. A BREAK
  5684.                          is a mark condition on the communications line for
  5685.                          approximately 300 milliseconds. CTRL-V appears  in
  5686.                          the directory as a small square block.
  5687.  
  5688.           CTRL-T :       causes the dialer to wait for the  character after
  5689.                          the CTRL-T in the command before it continues with
  5690.                          the command. Neither the CTRL-T nor the turnaround
  5691.                          character following is sent  to  the  modem. While
  5692.                          PC-VT is  waiting, you can press any key and PC-VT
  5693.                          goes on to  the  next  character  in  the command.
  5694.                          CTRL-T appears in the directory as a PI symbol.
  5695.  
  5696.           Only  your imagination limits you as to how  you  can  use  these
  5697.           dialer  commands.  You  can  have  PC-VT dial your host, wait  10
  5698.           seconds, enter your userid, wait  10 seconds, and then enter your
  5699.           password.
  5700.  
  5701.                   Special notes on the directory: You have complete control
  5702.           over the entire directory from columns 1 to 70. You can type over
  5703.           the  "ATDT"  command  and you can type any special modem commands
  5704.           like "," or ";".  You  can enter any key (including the Backspace
  5705.           key) except the control keys listed above into  the  command. You
  5706.           can  change  the  "ATDT" to any other modem command. For example,
  5707.           you can change the last line to "ATM2;"  and  when  you  move the
  5708.           cursor to that line and press F1, the modem is commanded  to turn
  5709.           on the speaker at  all  times. Just remember that PC-VT sends any
  5710.           character  in columns 21 to 70 to the modem when you press the F1
  5711.           key.  PC-VT  always  sends a carriage return right after it sends
  5712.           the last character in the number field. For users  of  the  PCjr,
  5713.           you can enter the CTRL-N command required by its internal modem.
  5714.  
  5715.                   In the examples below, the CTRL-F is shown as a ? and the
  5716.           CTRL-X is shown as a ^.
  5717.  
  5718.                   Here are some possible entries:
  5719.  
  5720.  
  5721.                               !
  5722.           Mark C DiVecchio    ATDT,,555-1212
  5723.           The computer        ATDT 1 - 506 - 555 - 1234,,,,,222* 432#
  5724.           Speaker on          ATM2;
  5725.           Full Logon          ATDT,555-1212~?~userid~password~^
  5726.  
  5727.                   In that last example,  the  modem  is  summoned, it is to
  5728.           wait  2 seconds for the dial tone (a  Hayes  modem  command),  it
  5729.           dials the number,  waits  for  Data  Set  Ready  to  indicate the
  5730.           connection is made, sends a single carriage return which wakes up
  5731.           the  host,  enters  the userid and then enters the password. Note
  5732.           the  final  CTRL-X.  This is needed to tell PC-VT not to send the
  5733.           spaces between the password and column 70 to the host  since they
  5734.           may be seen as part of the password.
  5735.  
  5736.  
  5737.  
  5738.  
  5739.           Page 82
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5747.  
  5748.  
  5749.                   One other thing is done by this facility in order  to get
  5750.           around the buffer size within the modem. Spaces and dashes in the
  5751.           phone number are not sent to the modem. With several  modems, the
  5752.           buffers could overflow if all 50 characters in  the  phone number
  5753.           field were sent. PC-VT resumes sending spaces after it encounters
  5754.           the first tilde. This  means  that spaces can be included as part
  5755.           of the logon sequence.
  5756.  
  5757.           Here are the functions available in the DIALING frame:
  5758.  
  5759.  
  5760.           Exit DIALING :
  5761.                          The Esc key returns  PC-VT  to  the communications
  5762.                          frame.
  5763.  
  5764.           Dial :         The "F1"  key dials the number in the line pointed
  5765.                          to by the cursor. Before the dialing  takes place,
  5766.                          PC-VT restores the  SETUP information to the state
  5767.                          it was when you initially  saved  this  host phone
  5768.                          number. This permits you to save a specific set of
  5769.                          SETUP features with  each host phone number. PC-VT
  5770.                          then returns to the communications frame.
  5771.  
  5772.           Toggle DTR :   The "F2" key toggles the  DTR  signal  out  of the
  5773.                          serial port  to  the  opposite  state.  A  message
  5774.                          appears at the bottom of the screen indicating the
  5775.                          new state.
  5776.  
  5777.           Read Directory:
  5778.                          The   "F3"   key   clears  the  displayed  dialing
  5779.                          directory and  reloads  it  from  the  disk  file,
  5780.                          DIALER.DAT, on the default drive. PC-VT remains in
  5781.                          the DIALING frame. The SETUP information which was
  5782.                          saved with the selected host is restored.
  5783.  
  5784.           Store Directory:
  5785.                          The   "F4"   key   stores  the  displayed  dialing
  5786.                          directory into a  disk  file  on  the  DOS default
  5787.                          drive or the  drive  pointed  to  by  the "PC-VT="
  5788.                          string in the environment. The name of the file is
  5789.                          DIALER.DAT.  In  addition  to the directory, PC-VT
  5790.                          saves the SETUP information for  each  entry  in a
  5791.                          special spot in  the dialing directory. This means
  5792.                          that  when  you  later  dial  this  number,  PC-VT
  5793.                          reloads all of the SETUP  options  like  baud rate
  5794.                          and feature selections associated with  this host.
  5795.                          Be certain though, that you select  the  host with
  5796.                          the cursor. This selected host is the one which is
  5797.                          associated  with the current SETUP information.  A
  5798.                          message appears at  the  bottom  of  the  frame to
  5799.                          indicate  that  the new directory  is  written  to
  5800.                          disk.
  5801.  
  5802.  
  5803.  
  5804.  
  5805.                                                                     Page 83
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.           DIALING Frame                                         PC-VT v10.0
  5813.  
  5814.  
  5815.           Hang up:       The "F5" key sends the  command  to  the  modem to
  5816.                          hang up the phone. This procedure takes  about 2-3
  5817.                          seconds due  to  the  modem  protocol.  A  message
  5818.                          appears at the bottom of the  display  to indicate
  5819.                          that the phone line is  hung  up.  PC-VT  uses the
  5820.                          Hayes  commands  "+++"   and  "ATH0"  to  do  this
  5821.                          function.  This function can also be performed  by
  5822.                          pressing ALT-Z in the communications frame.
  5823.  
  5824.                   The current host is  shown  on the SETUP B frame. This is
  5825.           to remind you when you are updating the  SETUP  information which
  5826.           host's information you are modifying.
  5827.  
  5828.  
  5829.           9.2  Saving SETUP Information
  5830.  
  5831.  
  5832.                   As mentioned above, PC-VT saves a complete picture of the
  5833.           SETUP information with  each  of  the  10  hosts  in  the dialing
  5834.           directory.
  5835.  
  5836.                   Each  time  that  the  F4  key is pressed in the  DIALING
  5837.           frame,  PC-VT  saves  not only the 10 entry dialing directory but
  5838.           also saves the  current  SETUP information and associates it with
  5839.           the host pointed to by the cursor.
  5840.  
  5841.                   To update the SETUP  information  for  a  particular host
  5842.           follow these steps:
  5843.  
  5844.  
  5845.             1.  From the communication frame  press  CTRL-F9  to  enter the
  5846.                 DIALING frame.
  5847.  
  5848.             2.  Use  the  up  and down arrow keys to move the cursor to the
  5849.                 line of the host (the cursor can be anywhere on the line).
  5850.  
  5851.             3.  Press  the  F3  key  which  loads  any   SETUP  information
  5852.                 previously associated with that host into PC-VT.
  5853.  
  5854.             4.  Press the Esc key to return to the communications frame.
  5855.  
  5856.             5.  Press the CTRL-F1 key to enter the SETUP frame.
  5857.  
  5858.             6.  Proceed to modify the SETUP information  as  appropriate to
  5859.                 the host.
  5860.  
  5861.             7.  Press the Esc key to return to the communications frame.
  5862.  
  5863.             8.  At this point, you may call  the  host and be sure that the
  5864.                 SETUP information set is correct.
  5865.  
  5866.             9.  Press the CTRL-F9 key to enter the DIALING frame.
  5867.  
  5868.  
  5869.  
  5870.  
  5871.           Page 84
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.           PC-VT v10.0                                 VT100 & 4014 Emulator
  5879.  
  5880.  
  5881.            10.  Make sure that the cursor is pointing to the  line  of  the
  5882.                 host.
  5883.  
  5884.            11.  Press  the  F4  key  to  save  the  SETUP  information  and
  5885.                 associate it with this host.
  5886.  
  5887.                   Now each time that  you  dial this host using the F1 key,
  5888.           PC-VT reloads the SETUP information before it starts to dial.
  5889.  
  5890.  
  5891.           9.3  Dialing From the DOS Command Line
  5892.  
  5893.  
  5894.                   You  can tell PC-VT to dial the  number  in  the  DIALING
  5895.           frame as soon at it starts  running.  Do this from the DOS prompt
  5896.           by starting PC-VT with:
  5897.  
  5898.                   pc-vt/dnn
  5899.  
  5900.           where  n  is  a  number  from  1  to 10.  The  number  picks  the
  5901.           corresponding entry in the dialing directory and dials the number
  5902.           during  the  PC-VT  start  up  sequence. This lets you start  the
  5903.           program and immediately dial a number. The dialing entry can be a
  5904.           complete logon macro as described above.
  5905.  
  5906.  
  5907.           9.4  The DIALER.DAT File
  5908.  
  5909.  
  5910.                   PC-VT maintains a dialing directory  file  on  disk. This
  5911.           file is used to record user defined phone numbers or  other modem
  5912.           commands.
  5913.  
  5914.                   The  file  consists  of 10 hosts. With each host there is
  5915.           stored  the  host  name, the phone numbers,  and  complete  setup
  5916.           information.
  5917.  
  5918.                   The host names and phone  numbers are read each time that
  5919.           you start up PC-VT  so  your  dialing  directory is restored each
  5920.           time. The setup information is read only if you specifically dial
  5921.           the host using the F1 key from the DIALING frame.
  5922.  
  5923.  
  5924.           9.4.1  Creation
  5925.  
  5926.  
  5927.                   The file is automatically created as  an  empty directory
  5928.           if  the  file does not exist on  the  default  drive  when  PC-VT
  5929.           starts.
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.                                                                     Page 85
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.           DIALING Frame                                         PC-VT v10.0
  5945.  
  5946.  
  5947.  
  5948.           9.4.2  Location
  5949.  
  5950.  
  5951.                   The file name is DIALER.DAT. The file is  created  in the
  5952.           directory pointed to  by   the 'PC-VT='string in the environment.
  5953.           If there is no such string in the environment the file is created
  5954.           on the DOS default drive. Chapter 3 on  starting  PC-VT describes
  5955.           how to use this string.
  5956.  
  5957.  
  5958.           9.4.3  Updating
  5959.  
  5960.  
  5961.                   The file is rewritten by pressing F4 while in the DIALING
  5962.           frame.
  5963.  
  5964.  
  5965.           9.5  Error Messages
  5966.  
  5967.  
  5968.                   There are  several  messages  generated  by  PC-VT  while
  5969.           manipulating this file.
  5970.  
  5971.            "New Dialing Directory Created":
  5972.                          PC-VT  could  not  find  DIALER.DAT on the default
  5973.                          disk drive  so  it  created  a  blank  file. PC-VT
  5974.                          continues.
  5975.  
  5976.           "Disk Directory Full":
  5977.                          PC-VT could not find space in the directory of the
  5978.                          default disk drive when  it  tried  to  create the
  5979.                          DIALER.DAT file. PC-VT terminates.
  5980.  
  5981.           "Disk Full While Writing Dialing Dir":
  5982.                          PC-VT ran out  of  space on the default disk drive
  5983.                          while   creating   the  DIALER.DAT   file.   PC-VT
  5984.                          terminates.
  5985.  
  5986.           "Disk Swap Error - See User Manual":
  5987.                          PC-VT found a different  diskette  in  the default
  5988.                          drive from the time that the disk  directory entry
  5989.                          was  created and the file DIALER.DAT was  written.
  5990.                          Since the time between these  two  events  is very
  5991.                          small,  this  error  message  indicates  a  severe
  5992.                          hardware or system failure. PC-VT terminates. This
  5993.                          error should never  happen  if PC-VT is run from a
  5994.                          fixed disk.
  5995.  
  5996.           "Error While Opening Dialing Directory":
  5997.                          PC-VT  failed to successfully open the  DIALER.DAT
  5998.                          file on the default disk. This usually  means that
  5999.                          the   disk  directory  has  been  damaged.   PC-VT
  6000.                          terminates.
  6001.  
  6002.  
  6003.           Page 86
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6011.  
  6012.  
  6013.           "Dialing Directory Access Error":
  6014.                          An error  occurred  while  reading  the DIALER.DAT
  6015.                          file from the default disk. Usually means that the
  6016.                          file  has  been  accidentally  overwritten.  PC-VT
  6017.                          terminates.
  6018.  
  6019.           "Can't find DIALER.DAT. F1 to cancel, space to try again.":
  6020.                          This usually means that the default diskette drive
  6021.                          is  empty  or  the  door  is  open.   Correct  the
  6022.                          situation and hit the space bar to continue. Press
  6023.                          F1 to terminate PC-VT.
  6024.  
  6025.           "DIALER.DAT could not be written":
  6026.                          This   usually  means  that  the  disk  is   write
  6027.                          protected or you specified an illegal drive letter
  6028.                          in the "PC-VT=" environment string.
  6029.  
  6030.           "Data Terminal Ready (DTR) now a 0/1":
  6031.                          You have pressed  F2  and  PC-VT  has  changed the
  6032.                          state of the DTR line to the modem.
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.                                                                     Page 87
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.           DIALING Frame                                         PC-VT v10.0
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.  
  6100.  
  6101.  
  6102.  
  6103.  
  6104.  
  6105.  
  6106.  
  6107.  
  6108.  
  6109.  
  6110.  
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.  
  6117.  
  6118.  
  6119.  
  6120.  
  6121.  
  6122.  
  6123.  
  6124.  
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.           Page 88
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.                                      Chapter 10
  6152.  
  6153.                                      MACRO Frame
  6154.  
  6155.  
  6156.           The MACRO frame is  used  to  update  the currently defined macro
  6157.           keys  and  is  accessed  by  pressing  CTRL-F10  from  the  VT100
  6158.           communications frame. The contents  of  the  communications frame
  6159.           are preserved and restored when you exit MACRO. A  macro  can  be
  6160.           sent  by  pressing  ALT-F1  thru   ALT-F10   directly   from  the
  6161.           communications frame. Only these 10  keys  are  supported  by the
  6162.           macro processor.
  6163.  
  6164.           Here are the functions available in the MACRO frame:
  6165.  
  6166.  
  6167.           Function                Key(s)
  6168.  
  6169.           Exit MACRO :   "Esc" returns PC-VT to the communications frame.
  6170.  
  6171.           Dial :         "F1" sends the macro in the line pointed to by the
  6172.                          cursor.  PC-VT then returns to the  communications
  6173.                          frame.  To  send   the  macro  directly  from  the
  6174.                          communications frame, press ALT-Fx right  from the
  6175.                          communications frame. There is  no  need  to press
  6176.                          CTRL-F10 first.
  6177.  
  6178.           Read Directory:
  6179.                          "F3"  clears the  displayed  macro  directory  and
  6180.                          reloads it from the disk file,  MACRO.DAT,  on the
  6181.                          default drive. PC-VT remains in the MACRO frame.
  6182.  
  6183.           Store Directory:
  6184.                          "F4"  stores the displayed macro directory  into a
  6185.                          disk file on the  DOS  default  drive or the drive
  6186.                          and directory specified  in the 'PC-VT=' string in
  6187.                          the  environment.  The  name   of   the   file  is
  6188.                          MACRO.DAT. A message appears at the bottom  of the
  6189.                          frame  to  indicate  that  the  new  directory  is
  6190.                          written to disk.
  6191.  
  6192.  
  6193.           10.1  Instructions for MACRO
  6194.  
  6195.  
  6196.  
  6197.  
  6198.  
  6199.  
  6200.  
  6201.                                                                     Page 89
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.           MACRO Frame                                           PC-VT v10.0
  6209.  
  6210.  
  6211.                   The MACRO frame is used  to create, update and save macro
  6212.           key  definitions.  The  frame can hold  10  macro  keys.  The  10
  6213.           definable  keys,  ALT-F1  thru ALT-F10, are listed on the left of
  6214.           the screen. The macro commands are stored in columns  21  to  70.
  6215.           The "!" above column 21 is  to  remind you that, when expanding a
  6216.           macro, PC-VT sends the data in columns 21 thru 70 to the modem as
  6217.           the macro command.
  6218.  
  6219.                   When PC-VT starts up, it looks for a  Macro  Directory on
  6220.           the default drive or the drive and directory pointed  to  by  the
  6221.           environment  string  'PC-VT='.  If it does not  find  one,  PC-VT
  6222.           creates a blank directory.
  6223.  
  6224.  
  6225.           10.1.1  Defining Macro Keys
  6226.  
  6227.  
  6228.                   You use the cursor keys, the Enter key, the Home  key and
  6229.           the End key to position the  cursor  to  any line.  The "Ins" key
  6230.           inserts a space at the cursor position and the "Del"  key deletes
  6231.           a character at the cursor position.
  6232.  
  6233.                   Here is how each of  cursor control keys functions in the
  6234.           macro frame:
  6235.  
  6236.           Left arrow :   moves the cursor one  column  to  the left. If the
  6237.                          cursor is already in column 21, the  speaker beeps
  6238.                          and  no  action  is  taken.  Use  this  key  as  a
  6239.                          backspace then press the space  bar  to  clear the
  6240.                          character.
  6241.  
  6242.           Right arrow :  moves the cursor  one  column to the right. If the
  6243.                          cursor is already in column 70, the  speaker beeps
  6244.                          and no action is taken.
  6245.  
  6246.           Up arrow :     moves  the cursor up one row.  If  the  cursor  is
  6247.                          already in  the  top  row  of  the  directory, the
  6248.                          speaker beeps and no action is taken.
  6249.  
  6250.           Down arrow :   moves the cursor down  one  row.  If the cursor is
  6251.                          already in the bottom row  of  the  directory, the
  6252.                          speaker beeps and no action is taken.
  6253.  
  6254.           Home :         moves  the  cursor  to column 21 of the top row of
  6255.                          the directory.
  6256.  
  6257.           End :          moves the cursor to column 21 of the bottom row of
  6258.                          the directory.
  6259.  
  6260.           Enter :        moves the cursor to column 21 of the  next  row of
  6261.                          the directory. If the  cursor  is  already  in the
  6262.                          bottom row of the directory, the  cursor  is moved
  6263.                          to column 21 of that row and the speaker beeps. If
  6264.                          you want to use the 'Enter' as part  of  the macro
  6265.  
  6266.  
  6267.           Page 90
  6268.  
  6269.  
  6270.  
  6271.  
  6272.  
  6273.  
  6274.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6275.  
  6276.  
  6277.                          definition, use the  tilde key '~'. PC-VT replaces
  6278.                          the tilde with a carriage return when the macro is
  6279.                          expanded.
  6280.  
  6281.           Ins :          inserts  a  space  at  the  cursor  position.  All
  6282.                          characters from the cursor to right  of  the field
  6283.                          are moved one column to the right. Anything in the
  6284.                          rightmost column of the field is lost.
  6285.  
  6286.           Del :          deletes a character at  the  cursor  position. All
  6287.                          characters from the right  of  the  cursor  to the
  6288.                          rightmost column of the field are moved one column
  6289.                          to  the  left.  A  space  is  inserted   into  the
  6290.                          rightmost column of the field.
  6291.  
  6292.                   Move the cursor to the first column of the key  which you
  6293.           want to define. Then enter the definition. Save the new directory
  6294.           by pressing F4.
  6295.  
  6296.  
  6297.           10.1.2  Sending Macros
  6298.  
  6299.  
  6300.           The macro can be sent by pressing the F1 key.  Once  you are back
  6301.           in  the  communications  frame,  you  can send the macro just  by
  6302.           pressing  the  ALT-Fx  key.  There  is no need to press  CTRL-F10
  6303.           first.
  6304.  
  6305.                   Pressing any key while  the  macro  is  being transmitted
  6306.           causes  PC-VT  to  stop  the   expansion   and   return   to  the
  6307.           communications frame.
  6308.  
  6309.  
  6310.                   Special notes on the macro directory:  You  have complete
  6311.           control over the entire  directory  from  columns  21 to 70. Just
  6312.           remember that PC-VT sends any character in columns 21  to  70  to
  6313.           the  Host  when  you  invoke  the  macro.  PC-VT  does not send a
  6314.           carriage return after it sends the last character in the line. If
  6315.           you want a carriage  return,  enter  the  tilde character. If you
  6316.           don't  put  in  a tilde, PC-VT sends whatever characters you have
  6317.           defined and then just goes back into keyboard input mode. You can
  6318.           type in additional characters or manually press the enter key.
  6319.  
  6320.                   In addition,  PC-VT does a little more work. As mentioned
  6321.           above, if you enter the tilde key (the ~), PC-VT  translates that
  6322.           into a carriage  return  (ASCII  13)  when sent to the Host. This
  6323.           permits  you  to  send  multiple  lines.  PC-VT   translates  the
  6324.           underscore, '_', into the Escape character (ASCII 27).
  6325.  
  6326.                   PC-VT interprets several  control characters in the macro
  6327.           command line as special commands:
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.                                                                     Page 91
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.           MACRO Frame                                           PC-VT v10.0
  6341.  
  6342.  
  6343.           CTRL-W :       causes   the  macro  to  wait  5  seconds   before
  6344.                          continuing with the command. CTRL-W appears in the
  6345.                          directory as an underlined up-down arrow.
  6346.  
  6347.           CTRL-B :       causes  the  macro  to   wait   1   second  before
  6348.                          continuing with the command. CTRL-B appears in the
  6349.                          directory as a Happy Face.
  6350.  
  6351.           CTRL-X :       stops the macro  at  that  point  in  the command.
  6352.                          CTRL-X appears in the  directory  as  an up-arrow.
  6353.                          PC-VT returns to keyboard input mode.
  6354.  
  6355.           CTRL-D :       causes the macro to wait  for  the  Carrier Detect
  6356.                          signal  from the modem before continuing to  send.
  6357.                          While PC-VT  is waiting, you can press any key and
  6358.                          PC-VT goes  on to the next character in the macro.
  6359.                          CTRL-D appears in the directory as a diamond. Some
  6360.                          modems require  you to set a special switch in the
  6361.                          modem   itself  for  Carrier  Detect  to   operate
  6362.                          correctly. Check your modem manual.
  6363.  
  6364.           CTRL-F :       causes the macro to  wait  for  the Data Set Ready
  6365.                          signal  from the modem before continuing to  send.
  6366.                          While PC-VT  is waiting, you can press any key and
  6367.                          PC-VT goes  on to the next character in the macro.
  6368.                          CTRL-F appears in the directory as a spade.
  6369.  
  6370.           CTRL-Q :       quotes the  next  character.  That  is,  the  next
  6371.                          character in the macro is be sent to  the  host no
  6372.                          matter what it is.  This  is  used  if you need to
  6373.                          send one of the  control  characters  described in
  6374.                          this  section  which  PC-VT  normally  uses  as  a
  6375.                          special command.
  6376.  
  6377.           CTRL-T :       causes the macro to wait for  the  character after
  6378.                          the CTRL-T in the command before it continues with
  6379.                          the command. Neither the CTRL-T nor the turnaround
  6380.                          character following is sent to the host. While PC-
  6381.                          VT is waiting, you can  press  any  key  and PC-VT
  6382.                          goes on to the next character in the macro. CTRL-T
  6383.                          appears in the directory as a PI symbol.
  6384.  
  6385.           Only your imagination limits you as to how you can use  this. You
  6386.           can have PC-VT enter a command, wait 10 seconds, enter an option,
  6387.           wait 6  seconds,  end  a  job and log you off the host. All other
  6388.           control characters  can  be  entered  into  the  macro definition
  6389.           including  backspace  and  CTRL-C. They are sent to the host when
  6390.           the macro is expanded.
  6391.  
  6392.                   In the examples below, the CTRL-W is shown as a ? and the
  6393.           CTRL-X is shown as a ^.
  6394.  
  6395.                   Here are some possible entries:
  6396.  
  6397.  
  6398.  
  6399.           Page 92
  6400.  
  6401.  
  6402.  
  6403.  
  6404.  
  6405.  
  6406.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6407.  
  6408.  
  6409.                               !
  6410.           ALT-F1              run myjob~^
  6411.           ALT-F2              mail~?1~???~~~~ex~^
  6412.           ALT-F3              ATDT5551212~^
  6413.           ALT-F4              _[A^
  6414.  
  6415.                   It is always  wise  to  put  a  CTRL-X a the end of every
  6416.           macro  so  that  PC-VT knows exactly where to stop sending. PC-VT
  6417.           sends the spaces out to column 70 if you leave off the CTRL-X. In
  6418.           most cases this probably  won't  matter  but when trailing spaces
  6419.           are significant(like in a password), you need the CTRL-X.
  6420.  
  6421.                   You can also use the macro key definition to dial through
  6422.           a smart modem. Simply put the dialing command in as a macro. Then
  6423.           press the appropriate ALT-Fx key from the communications frame.
  6424.  
  6425.  
  6426.           10.2  Downloading Macro Keys
  6427.  
  6428.  
  6429.                   The 10 macro keys used by PC-VT can be set from  the host
  6430.           when  the  emulator  is in VT mode. Up to 50  characters  can  be
  6431.           specified in the same format as described above. Use the  tilde ~
  6432.           character  for  the  Enter  key.  You cannot include  the  Escape
  6433.           character in the string. If you want an Escape character, use the
  6434.           underline character, '_', in the  string  which  you  send. PC-VT
  6435.           converts  the  underline  to  an  Escape  character.  You  cannot
  6436.           download any  of the special CTRL characters which are acceptable
  6437.           to the macro processor when entered from the keyboard.
  6438.  
  6439.                   The Escape sequence is:
  6440.  
  6441.  
  6442.           ESC [ 0 ; Pk ; "string" p
  6443.                          Sets macro  key Pk to the string given. The double
  6444.                          quotes   and   all   other  characters  shown  are
  6445.                          required. The number  Pk  must  be  sent  as ASCII
  6446.                          characters just like all other sequences.
  6447.  
  6448.                          Example to set the ALT-F1 key:
  6449.  
  6450.           ESC [ 0 ; 1 ; "run able~dir~set def [dir1.dir2]~logout~" p
  6451.  
  6452.           ESC [ 0 ; Pk ; 0 ; Pk p
  6453.                          Clears the macro key Pk to a null string.
  6454.  
  6455.                          Example  to  clear  any definition associated with
  6456.                          the ALT-F4 key:
  6457.  
  6458.                          ESC [ 0 ; 4 ; 0 ; 4 p
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.                                                                     Page 93
  6466.  
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472.           MACRO Frame                                           PC-VT v10.0
  6473.  
  6474.  
  6475.                          where Pk is:
  6476.                          1       ALT-F1
  6477.                          2       ALT-F2
  6478.                          3       ALT-F3
  6479.                          4       ALT-F4
  6480.                          5       ALT-F5
  6481.                          6       ALT-F6
  6482.                          7       ALT-F7
  6483.                          8       ALT-F8
  6484.                          9       ALT-F9
  6485.                          10      ALT-F10
  6486.  
  6487.  
  6488.           10.3  The MACRO.DAT File
  6489.  
  6490.  
  6491.                   PC-VT maintains a macro directory file on disk. This file
  6492.           is used to record user defined macro key definitions. The file is
  6493.           read each time that you start up PC-VT so your macro directory is
  6494.           restored each time.
  6495.  
  6496.  
  6497.           10.3.1  Creation
  6498.  
  6499.  
  6500.                   The MACRO.DAT file is automatically created  as  an empty
  6501.           directory if the file does not exist on the  default  drive  when
  6502.           PC-VT starts.
  6503.  
  6504.  
  6505.           10.3.2  Location
  6506.  
  6507.  
  6508.                   The  file  name  is MACRO.DAT. The file is created in the
  6509.           directory pointed to  by   the "PC-VT="string in the environment.
  6510.           If there is no such string in the environment the file is created
  6511.           on the DOS default drive. Chapter 3 on  starting  PC-VT describes
  6512.           how to use this string.
  6513.  
  6514.  
  6515.           10.3.3  Updating
  6516.  
  6517.  
  6518.                   The MACRO.DAT file is rewritten upon request while in the
  6519.           MACRO frame by pressing F4.
  6520.  
  6521.  
  6522.           10.4  Error Messages
  6523.  
  6524.  
  6525.                   Several error messages can be  generated  by  PC-VT while
  6526.           manipulating this file.
  6527.  
  6528.  
  6529.  
  6530.  
  6531.           Page 94
  6532.  
  6533.  
  6534.  
  6535.  
  6536.  
  6537.  
  6538.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6539.  
  6540.  
  6541.           "New Macro Key File Created":
  6542.                          PC-VT could not find MACRO.DAT on the default disk
  6543.                          drive  so  it created an  empty  directory.  PC-VT
  6544.                          continues.
  6545.  
  6546.           "Disk Directory Full":
  6547.                          PC-VT could not find space in the directory of the
  6548.                          default disk drive when  it  tried  to  create the
  6549.                          MACRO.DAT file. PC-VT terminates.
  6550.  
  6551.           "Disk Full While Writing Macro Key File":
  6552.                          PC-VT ran out  of  space on the default disk drive
  6553.                          while   creating   the   MACRO.DAT   file.   PC-VT
  6554.                          terminates.
  6555.  
  6556.           "Disk Swap Error - See User Manual":
  6557.                          PC-VT found a different  diskette  in  the default
  6558.                          drive from the time that the disk  directory entry
  6559.                          was created and the  file  MACRO.DAT  was written.
  6560.                          Since the time between these  two  events  is very
  6561.                          small,  this  error  message  indicates  a  severe
  6562.                          hardware or system failure. PC-VT terminates. This
  6563.                          error should never  happen  if PC-VT is run from a
  6564.                          fixed disk.
  6565.  
  6566.           "Error While Opening Macro Key File":
  6567.                          PC-VT  failed  to  successfully open the MACRO.DAT
  6568.                          file on the default disk. This usually  means that
  6569.                          the   disk  directory  has  been  damaged.   PC-VT
  6570.                          terminates.
  6571.  
  6572.           "Macro Key File Access Error":
  6573.                          An error occurred while reading the MACRO.DAT file
  6574.                          from the default disk. Usually means that the file
  6575.                          has   been    accidentally    overwritten.   PC-VT
  6576.                          terminates.
  6577.  
  6578.           "Can't find MACRO.DAT. F1 to cancel, space to try again.":
  6579.                          This usually means that the default diskette drive
  6580.                          is  empty  or  the  door  is  open.   Correct  the
  6581.                          situation and hit the space key to continue. Press
  6582.                          F1 to terminate PC-VT.
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.                                                                     Page 95
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.           MACRO Frame                                           PC-VT v10.0
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.  
  6612.  
  6613.  
  6614.  
  6615.  
  6616.  
  6617.  
  6618.  
  6619.  
  6620.  
  6621.  
  6622.  
  6623.  
  6624.  
  6625.  
  6626.  
  6627.  
  6628.  
  6629.  
  6630.  
  6631.  
  6632.  
  6633.  
  6634.  
  6635.  
  6636.  
  6637.  
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.  
  6649.  
  6650.  
  6651.  
  6652.  
  6653.  
  6654.  
  6655.  
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.           Page 96
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6671.  
  6672.  
  6673.  
  6674.  
  6675.  
  6676.  
  6677.  
  6678.  
  6679.                                      Chapter 11
  6680.  
  6681.                                    4014 Emulation
  6682.  
  6683.  
  6684.                   The 4014 emulator requires either the IBM  Color Graphics
  6685.           Adapter, the Everex Edge Monochrome/Color  Graphics  Card  or the
  6686.           Hercules Graphics  Card. You start the emulator by pressing ALT-T
  6687.           from the VT100 Emulator or by starting PC-VT with the  /t command
  6688.           line option. You must have specified /e when you started PC-VT if
  6689.           you  have  the  Everex Edge card  installed  and  you  must  have
  6690.           specified /h if you have the Hercules Graphics Card installed.
  6691.  
  6692.                   If you don't have a graphics card in your  PC,  you  will
  6693.           see an error message at the bottom of the screen and  PC-VT stays
  6694.           in VT emulation mode.
  6695.  
  6696.                   When  the  4014  emulator starts up, you will see a short
  6697.           help message in the upper right of the screen and the rest of the
  6698.           screen will be  blank.  What  you  won't see is a cursor. Neither
  6699.           IBM's Color Graphics Adapter card,  Everex's  Edge  card,  or the
  6700.           Hercules card supplies a cursor when those boards are operated in
  6701.           graphics mode. This shouldn't  be  a problem in most cases as the
  6702.           last prompt indicates the cursor position.
  6703.  
  6704.                   The  F2  key  emulates the PAGE key on the 4014. Pressing
  6705.           that key clears the screen and places the invisible cursor at the
  6706.           upper  left of the screen. If you have  selected  the  Page  Full
  6707.           feature in the SETUP  B  frame, the speaker beeps when the screen
  6708.           fills with  text.  This  beep  is  lower  pitched beep so you can
  6709.           distinguish it from  other  beeps.  You  must press the F2 key to
  6710.           continue.
  6711.  
  6712.                   Terminal  Setup,   Dialing   Directory   and   Macro  key
  6713.           definition must be done from VT100 emulation mode.
  6714.  
  6715.                   Since the PC screen is not the same as the Tektronix 4014
  6716.           screen,  the    following  adjustment  is  made  (high resolution
  6717.           coordinates are shown in parentheses):
  6718.  
  6719.           For the 4010:
  6720.           X scale = Tekpoints 0-1023 are mapped into PC 0-639(720)
  6721.           Y scale = Tekpoints 0-779  are mapped into PC 0-199(348)
  6722.                     Y points 780-1023 map above the screen but are
  6723.                     still valid.
  6724.  
  6725.  
  6726.  
  6727.  
  6728.  
  6729.                                                                     Page 97
  6730.  
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.           4014 Emulation                                        PC-VT v10.0
  6737.  
  6738.  
  6739.           For the 4014:
  6740.           X scale = Tekpoints 0-4095 are mapped into PC 0-639(720)
  6741.           Y scale = Tekpoints 0-3119 are mapped into PC 0-199(348)
  6742.                     Y points 3120-4095 map above the screen but are
  6743.                     still valid.
  6744.  
  6745.                   Because of these adjustments, many Tekpoints  map  into a
  6746.           single dot on the PC's screen.
  6747.  
  6748.                   The other  adjustment that is made concerns the number of
  6749.           character positions  on the screen. The 4014 supports 4 character
  6750.           sets. PC-VT supports two character sets if you are using  the IBM
  6751.           Color Graphics Adapter - 25 lines  by  80 columns and 33 lines by
  6752.           106 columns. Because of  this,  the  exact character positions on
  6753.           some graphics output  from  the  host  may not appear in the same
  6754.           position  as  on a real 4014. The same is true if  you  have  the
  6755.           Everex Edge or Hercules card installed. The situation is a little
  6756.           better, though, as hardware  supports  43  lines of 90 characters
  6757.           and  58  lines  of 120 characters which more closely emulates the
  6758.           4014.
  6759.  
  6760.                   With all three graphics cards, the smaller  character set
  6761.           produces capital letters only.
  6762.  
  6763.                   Unlike a real 4014,  PC-VT  handles  XON  and XOFF like a
  6764.           VT100 even in 4014 mode. If you do not want this handshaking, you
  6765.           must disable the XON/XOFF feature in the SETUP B frame.
  6766.  
  6767.  
  6768.           11.1  4014 Options
  6769.  
  6770.  
  6771.                   Strap options on the 4014 are selectable from the SETUP B
  6772.           frame:
  6773.  
  6774.  
  6775.           Strap 1        Carriage Return effect  -  the ENTER key on the PC
  6776.                          can be set to send either a carriage  return  or a
  6777.                          carriage   return  and  a  linefeed.  Default   is
  6778.                          carriage return only.
  6779.  
  6780.           Strap 2        DEL Implies LOY -  PC-VT  can  be set to interpret
  6781.                          DEL  (ASCII 127) as a low order Y  code  or  as  a
  6782.                          RUBOUT. Defaults to low order Y code.
  6783.  
  6784.           Strap 3        Line Feed effect - the  CTRL-J  (linefeed)  key on
  6785.                          the PC can be set to send either just a  line feed
  6786.                          or a line  feed  and a carriage return. Default is
  6787.                          line feed only.
  6788.  
  6789.           Strap 4        GIN Terminator  -  A  single  carriage  return  is
  6790.                          normally sent  as  the  GIN  Terminator.  You  can
  6791.                          change this to no GIN terminator.
  6792.  
  6793.  
  6794.  
  6795.           Page 98
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6803.  
  6804.  
  6805.           11.2  4014 Keyboard Mapping
  6806.  
  6807.  
  6808.                   All ASCII character keys on  the  IBM  PC's  keyboard map
  6809.           directly into the corresponding keys for the 4014. The 4014 has a
  6810.           very simple  keyboard layout. Most of the keyboard's special keys
  6811.           have no effect in this mode.
  6812.  
  6813.  
  6814.           11.2.1  Regular Key Mapping
  6815.  
  6816.  
  6817.  
  6818.           4014 Key          PC Equivalent Key                  Notes
  6819.  
  6820.  
  6821.           PAGE KEY
  6822.  
  6823.                          F2          acts as the PAGE key on the  4014. The
  6824.                          screen is cleared and the  cursor  is  returned to
  6825.                          the home position.
  6826.  
  6827.  
  6828.  
  6829.           RESET
  6830.  
  6831.                           CTRL-HOME  acts as the RESET key on the 4014. The
  6832.                          screen is cleared, the  cursor  is  homed  and all
  6833.                          options are reset.
  6834.  
  6835.  
  6836.  
  6837.           Arrow Keys
  6838.  
  6839.                           Arrow Keys The  PC's  arrow  keys  are  used  for
  6840.                          cursor movement. In  conjunction with the Ins key,
  6841.                          the arrow keys cause faster cursor movement. Press
  6842.                          and release the Ins key and PC-VT moves the cursor
  6843.                          in larger steps. Press  and  release  the  Ins key
  6844.                          again and PC-VT returns cursor movement to 1 pixel
  6845.                          steps.
  6846.  
  6847.  
  6848.  
  6849.           RUBOUT
  6850.  
  6851.                           Del        "Del"  emulates the RUBOUT key on  the
  6852.                          4014.
  6853.  
  6854.  
  6855.  
  6856.           BACKSPACE
  6857.  
  6858.  
  6859.  
  6860.  
  6861.                                                                     Page 99
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.           4014 Emulation                                        PC-VT v10.0
  6869.  
  6870.  
  6871.                           Backspace  The  backspace  key  sends a backspace
  6872.                          character  to  the host. The  character  sent  can
  6873.                          either be an ASCII 8  or an ASCII 127 depending on
  6874.                          the setting of the backspace character bit  in the
  6875.                          SETUP B frame.
  6876.  
  6877.  
  6878.  
  6879.           TTY LOCK
  6880.  
  6881.                           Caps Lock  The Caps Lock key acts as the TTY lock
  6882.                          key on the 4010.
  6883.  
  6884.  
  6885.  
  6886.           ----
  6887.  
  6888.                           Scroll LockThe 4014 does not a have a hold screen
  6889.                          function. With PC-VT you can press SCROLL  LOCK to
  6890.                          stop  vector  drawing.  Pressing SCROLL LOCK again
  6891.                          resumes drawing.
  6892.  
  6893.  
  6894.  
  6895.  
  6896.           11.2.2  Control Function Keys
  6897.  
  6898.  
  6899.                   Most CTRL-Fx keys operate the  same  manner  as  in VT100
  6900.           emulation mode:
  6901.  
  6902.  
  6903.           Key             Function
  6904.  
  6905.           F1             Returns to VT100 emulation.
  6906.  
  6907.           CTRL-F2        Changes  the default disk directory for  uploading
  6908.                          and downloading files. See Chapter 8.
  6909.  
  6910.           CTRL-F3        Receives a file (ASCII or XMODEM). See Chapter 8.
  6911.  
  6912.           CTRL-F4        Transmits a file (ASCII or XMODEM). See Chapter 8.
  6913.  
  6914.           CTRL-F5        Prints the screenon  the selected printer (LPT1 or
  6915.                          LPT2), if present. The printer is selected  in the
  6916.                          SETUP B frame.  If the Print Termination Character
  6917.                          is set in the SETUP B frame, the paper is moved to
  6918.                          the  top  of  the next page after  the  screen  is
  6919.                          printed.
  6920.  
  6921.           CTRL-F7        Sends a BREAK. To  send  a  sustained break to the
  6922.                          host, press CTRL-F7. Confirmation of the operation
  6923.                          is  a  click  at the start of the break along with
  6924.                          another click at the end of the operation.
  6925.  
  6926.  
  6927.           Page 100
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.           PC-VT v10.0                                 VT100 & 4014 Emulator
  6935.  
  6936.  
  6937.           CTRL-F8        Terminates  the program,  clears  the  screen  and
  6938.                          returns control to DOS.
  6939.  
  6940.  
  6941.           11.2.3  ALT Keys
  6942.  
  6943.  
  6944.           ALT-F1 thru ALT-F10 :
  6945.                           Can be used as macro keys.
  6946.  
  6947.           ALT-H:         Enters the HELP frame.  Once  you  are in the HELP
  6948.                          frame, use the PgDn key to look at  the  next HELP
  6949.                          page, use the PgUp key  to  look  at  the previous
  6950.                          HELP  page,  and  use the Esc key to exit HELP and
  6951.                          return to  the  emulator.  HELP  works  from  most
  6952.                          frames and is context sensitive. That  is,  if you
  6953.                          need HELP within the 4014 communication frame, you
  6954.                          get 4014 information.
  6955.  
  6956.           ALT-K :        Starts  up  the KERMIT module.  See  the  attached
  6957.                          KERMIT document for details on its command set.
  6958.  
  6959.           ALT-F :        Starts up another copy of  COMMAND.COM.    This is
  6960.                          done without  terminating  PC-VT  or  breaking the
  6961.                          host  connection.   Once the  new  COMMAND.COM  is
  6962.                          started, you  can run any DOS function or other PC
  6963.                          program.  You should be careful that you don't run
  6964.                          a  program that uses the same communications  port
  6965.                          as PC-VT is  using  since  the  other  program may
  6966.                          leave the  port in an unexpected state.  PC-VT may
  6967.                          not then be able to get control of the port again.
  6968.                          Also be careful that  you  don't  alter  any files
  6969.                          which PC-VT may be using.  To  exit  from  the new
  6970.                          copy  of  COMMAND.COM and return  to  PC-VT,  type
  6971.                          "exit" at the command prompt.
  6972.  
  6973.           ALT-Z :        Hangs   up  the  phone.PC-VT  performs  the   same
  6974.                          functions as if you had entered the  DIALING frame
  6975.                          and pressed F5. That is, the Hayes compatible hang
  6976.                          up command is sent to the modem.
  6977.  
  6978.  
  6979.           11.3  4014 Error Messages
  6980.  
  6981.  
  6982.           "4014 Graphics Emulation Requires the Color Graphics Adapter"
  6983.  
  6984.                          PC-VT  could  not find a  Color  Graphics  Adapter
  6985.                          card.  If  you  have  both  Monochrome  and  Color
  6986.                          Graphics  Adapter  cards  in  your system, you may
  6987.                          have left  off the /b option from the command line
  6988.                          when you started PC-VT.  If  you  have  the Everex
  6989.                          Edge card installed, you left off  the  /e option.
  6990.  
  6991.  
  6992.  
  6993.                                                                    Page 101
  6994.  
  6995.  
  6996.  
  6997.  
  6998.  
  6999.  
  7000.           4014 Emulation                                        PC-VT v10.0
  7001.  
  7002.  
  7003.                          If you have the Hercules card installed,  you left
  7004.                          off the /h option.
  7005.  
  7006.  
  7007.  
  7008.  
  7009.  
  7010.  
  7011.  
  7012.  
  7013.  
  7014.  
  7015.  
  7016.  
  7017.  
  7018.  
  7019.  
  7020.  
  7021.  
  7022.  
  7023.  
  7024.  
  7025.  
  7026.  
  7027.  
  7028.  
  7029.  
  7030.  
  7031.  
  7032.  
  7033.  
  7034.  
  7035.  
  7036.  
  7037.  
  7038.  
  7039.  
  7040.  
  7041.  
  7042.  
  7043.  
  7044.  
  7045.  
  7046.  
  7047.  
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.  
  7054.  
  7055.  
  7056.  
  7057.  
  7058.  
  7059.           Page 102
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7067.  
  7068.  
  7069.  
  7070.  
  7071.  
  7072.  
  7073.  
  7074.  
  7075.                                      Chapter 12
  7076.  
  7077.                                   PC-VT Status Line
  7078.  
  7079.  
  7080.                    When in the VT100 communications frame, PC-VT  uses line
  7081.           25  of  the  monitor as a status line. The VT100 only requires 24
  7082.           lines for proper operation.  The  4014  emulator does not display
  7083.           this  line.  The  meaning of each  of  the  fields  displayed  is
  7084.           summarized in this chapter.
  7085.  
  7086.  
  7087.           On Line        PC-VT is actively monitoring the COMx port.  It is
  7088.                          on line to a host only if you have established the
  7089.                          connection.
  7090.  
  7091.           Local          PC-VT  is performing some local function and  data
  7092.                          received on the COMx port  is  not  displayed. The
  7093.                          data is not lost  but  is  buffered  and displayed
  7094.                          when PC-VT returns  to  on line mode. Note that on
  7095.                          the  PCjr this may not be true.  If  the  PCjr  is
  7096.                          doing  a diskette operation, all other  interrupts
  7097.                          are masked off. If  data  is  received on the COMx
  7098.                          line, it is lost.
  7099.  
  7100.           Vx.x           The  version number of PC-VT. Please include  this
  7101.                          number if you write to us.
  7102.  
  7103.           KBD LOCKED     The  host  computer  has  locked the keyboard. The
  7104.                          host   is  also  responsible  for  unlocking   the
  7105.                          keyboard. PC-VT clicks the  speaker  if  a  key is
  7106.                          pressed when the keyboard is locked.
  7107.  
  7108.           CAP            The  Caps  Lock  key  has  been  depressed  on the
  7109.                          keyboard.
  7110.  
  7111.           NUM            The  Num  Lock  key  has  been  depressed  on  the
  7112.                          keyboard.
  7113.  
  7114.           SCR            The SCROLL LOCK  key  has  been  depressed  on the
  7115.                          keyboard. This key functions as the NO  SCROLL key
  7116.                          on the VT100.
  7117.  
  7118.           " "            The Greek letter alpha  is  displayed  to indicate
  7119.                          that  PC-VT is in VT100 Applications Keypad  mode.
  7120.                          This permits the PC's function and keypad  keys to
  7121.                          transmit special codes. See  chapter  5.  The host
  7122.                          controls entrance and exit to this mode.
  7123.  
  7124.  
  7125.                                                                    Page 103
  7126.  
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.           PC-VT Status Line                                     PC-VT v10.0
  7133.  
  7134.  
  7135.           X              Indicates that the host's buffer has filled up and
  7136.                          that the host is not accepting any more characters
  7137.                          from the PC. This  clears  automatically  when the
  7138.                          host's buffer has emptied.  Press  ALT-X  to clear
  7139.                          this flag in the cases  where  some  noise  on the
  7140.                          communications line happened to set it.
  7141.  
  7142.           P              Indicates that printer echo is turned  on  and all
  7143.                          characters displayed on  the screen are printed on
  7144.                          the  printer.  Characters  displayed on the status
  7145.                          line are never printed. Printer echo can be turned
  7146.                          on  by  the  host  via  an Escape sequence  or  by
  7147.                          pressing CTRL-F6 on the PC's keyboard.
  7148.  
  7149.           HH:MM:SS       Displays the time  of  day. This can be turned off
  7150.                          by resetting the CLOCK bit in the SETUP B frame.
  7151.  
  7152.           DSR            Indicates that the modem has raised  its  Data Set
  7153.                          Ready line. This indicator as well as the next two
  7154.                          modem status  indicators  can  be  turned  off  by
  7155.                          resetting the CLOCK bit in the SETUP B frame. Most
  7156.                          smart modems keep  this  line high at all times to
  7157.                          indicate that they  are ready to receive commands.
  7158.                          Note that PC-VT does not really care.  It displays
  7159.                          this only for information.
  7160.  
  7161.           CTS            Indicates that the modem has raised  its  Clear To
  7162.                          Send line. Some modems maintain this line  high at
  7163.                          all times.  There is usually a switch on the modem
  7164.                          which causes this  line to function normally. Note
  7165.                          that PC-VT does not really care. It  displays this
  7166.                          only for information.
  7167.  
  7168.           CD             Indicates that the modem  has  raised  its Carrier
  7169.                          Detect  line. Some modems maintain this line  high
  7170.                          at all times. There is  usually  a  switch  on the
  7171.                          modem which causes this line to function normally.
  7172.                          Note that PC-VT does not really care.  It displays
  7173.                          this only for information.
  7174.  
  7175.           L1L2L3L4       These represent the LED's on the  VT100.  All four
  7176.                          are used on the VT100  and the VT102, and none are
  7177.                          used on the VT52.
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  
  7189.  
  7190.  
  7191.           Page 104
  7192.  
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7199.  
  7200.  
  7201.  
  7202.  
  7203.  
  7204.  
  7205.  
  7206.  
  7207.                                      Chapter 13
  7208.  
  7209.                                    Error Messages
  7210.  
  7211.  
  7212.                   This chapter  lists error messages which do not appear in
  7213.           other chapters or which deserve a more detailed explanation.
  7214.  
  7215.                   Error   messages   regarding   the   USER   MEMORY   file
  7216.           (PARAMS.DAT)  may  be  found  at  the end of Chapter 7.  Messages
  7217.           regarding file transfer  may  be  found  at the end of Chapter 8.
  7218.           Dialer messages are at  the  end of Chapter 9. Macro messages are
  7219.           at the end of Chapter 10.
  7220.  
  7221.                   PC-VT detects  all errors which occur while it is running
  7222.           in  order   to  notify  the  user  and  terminate  gracefully  if
  7223.           necessary.
  7224.  
  7225.  
  7226.           "PC-VT Requires DOS 2.0 or later.":
  7227.                          PC-VT  requires  DOS  2.0  or  later  in  order to
  7228.                          execute.
  7229.  
  7230.           "Sorry, not enough memory for HELP":
  7231.                          PC-VT  dynamically  allocates  memory for the HELP
  7232.                          data. This message  says that the Operating System
  7233.                          could not  allocate  PC-VT  the  additional memory
  7234.                          that it needed for the HELP frame.
  7235.  
  7236.           "Sorry, could not load the HELP file":
  7237.                          PC-VT could not  find  the  HELP.DAT  file  on the
  7238.                          default drive or the drive specified  by  the "PC-
  7239.                          VT="  environment  string. If you  are  running  a
  7240.                          diskette system, you  must have the PC-VT diskette
  7241.                          with the HELP.DAT file in the drive the first time
  7242.                          that you press ALT-H. This is when PC-VT reads the
  7243.                          file into memory. After  the  first  press  of the
  7244.                          HELP key, the file is kept in memory  so  that the
  7245.                          copy on the diskette is no longer needed.
  7246.  
  7247.           "File COMMAND.COM could not be found. Error xx":
  7248.                          You just pressed ALT-F to start up another copy of
  7249.                          COMMAND.COM and PC-VT could not locate it on disk.
  7250.                          This usually means that if you  are  running PC-VT
  7251.                          from a floppy  diskette, you must copy COMMAND.COM
  7252.                          to   that  floppy   diskette.   PC-VT   uses   the
  7253.                          environment  string  "COMSPEC="   to   locate  the
  7254.                          COMMAND.COM   program.   This   string   is    set
  7255.  
  7256.  
  7257.                                                                    Page 105
  7258.  
  7259.  
  7260.  
  7261.  
  7262.  
  7263.  
  7264.           Error Messages                                        PC-VT v10.0
  7265.  
  7266.  
  7267.                          automatically to the boot drive when you  start up
  7268.                          PC-VT. To check to see  if  it  is  set correctly,
  7269.                          type in the  "SET"  command  from  the  DOS prompt
  7270.                          after you terminate PC-VT by pressing CTRL-F8. The
  7271.                          error  number  is described in  the  DOS  Software
  7272.                          Technical  Reference  Manual.  Some  of  the  more
  7273.                          common errors are:
  7274.  
  7275.                          02      COMMAND.COM not found
  7276.                          03      Path given in the "COMSPEC="
  7277.                                  string is invalid
  7278.                          05      Access Denied
  7279.  
  7280.           "File KERMIT.COM could not be found. Error xx":
  7281.                          You just pressed ALT-K to start up  KERMIT.COM and
  7282.                          PC-VT could not locate it  on  disk.  This usually
  7283.                          means that  if you are running PC-VT from a floppy
  7284.                          diskette, you must  copy KERMIT.COM to that floppy
  7285.                          diskette. PC-VT looks for the program first in the
  7286.                          DOS  search path set by the environment  variable,
  7287.                          "PATH=". Then it  looks in the directory specified
  7288.                          by the  "PC-VT="  variable.  To  check  to  see if
  7289.                          either of these  variables are set correctly, type
  7290.                          in the "SET" command from the DOS prompt after you
  7291.                          terminate PC-VT  by  pressing  CTRL-F8.  The error
  7292.                          number is described  in the DOS Software Technical
  7293.                          Reference  Manual. Some of the more common  errors
  7294.                          are:
  7295.  
  7296.                          02      KERMIT.COM not found
  7297.                          03      Path given in the "PATH=" or
  7298.                                  "PC-VT=" strings is invalid
  7299.                          05      Access Denied
  7300.  
  7301.           "Disk not ready or Fixed Disk  error.  Abort or Retry (Press a or
  7302.           r) ?":          PC-VT just encountered a  disk  error.  The error
  7303.                          most likely was caused by  a door open on a floppy
  7304.                          diskette drive. Correct the situation and have PC-
  7305.                          VT retry the operation by  pressing  'r'.  To have
  7306.                          PC-VT  abort the  disk  operation  and  terminate,
  7307.                          press 'a'.
  7308.  
  7309.           "Fatal FAT Error. PC-VT Terminating. Press any key.":
  7310.                          PC-VT just found a  fatal  error  in the disk File
  7311.                          Allocation Table (FAT). PC-VT cannot  continue and
  7312.                          terminates as soon as you press any key.
  7313.  
  7314.           "PC-VT Requires an 80 Column Display":
  7315.                          The VT100 is an 80  column  device  so  PC-VT must
  7316.                          have an 80 column output device.
  7317.  
  7318.           "PC-VT Terminated...":
  7319.                          Indicates that PC-VT  successfully  terminated. It
  7320.                          closed the communications  buffer so that any data
  7321.  
  7322.  
  7323.           Page 106
  7324.  
  7325.  
  7326.  
  7327.  
  7328.  
  7329.  
  7330.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7331.  
  7332.  
  7333.                          received is lost. If you want to get  back  to DOS
  7334.                          without closing the  communications  buffer, press
  7335.                          ALT-F instead of CTRL-F8.
  7336.  
  7337.           "Found old versions of PARAMS.DAT and DIALER.DAT files."
  7338.           "Delete them and restart PC-VT"
  7339.  
  7340.                          Your diskette or  fixed  disk  has  copies  of the
  7341.                          PARAMS.DAT  and DIALER.DAT  files  from  an  older
  7342.                          version  of  PC-VT. The newer  versions  of  PC-VT
  7343.                          cannot use these files. Delete these two files and
  7344.                          then  restart  the  program.  PC-VT  automatically
  7345.                          recreates the files in their new format.
  7346.  
  7347.           "EVEREX EDGE card must be in monochrome mode"
  7348.           "use this command at the DOS prompt :"
  7349.           "SETMODE -amono -c80 -r25 -mmono"
  7350.  
  7351.                          You have told PC-VT  to  use  the Everex Edge card
  7352.                          for display output  and  the card is set for color
  7353.                          mode. In order for PC-VT  to use the card, it must
  7354.                          be in  monochrome mode. At the DOS prompt, type in
  7355.                          the command shown.
  7356.  
  7357.           "When using both monitors, start PC-VT from"
  7358.           " the Monochrome monitor"
  7359.  
  7360.                          You have told PC-VT to  use both the color and the
  7361.                          monochrome  displays.  PC-VT  must be started from
  7362.                          the monochrome display in this  case.  At  the DOS
  7363.                          prompt, enter the DOS command "mode mono".
  7364.  
  7365.  
  7366.  
  7367.  
  7368.  
  7369.  
  7370.  
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.  
  7378.  
  7379.  
  7380.  
  7381.  
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.  
  7388.  
  7389.                                                                    Page 107
  7390.  
  7391.  
  7392.  
  7393.  
  7394.  
  7395.  
  7396.           Appendix 13                                           PC-VT v10.0
  7397.  
  7398.  
  7399.  
  7400.  
  7401.  
  7402.  
  7403.  
  7404.  
  7405.  
  7406.  
  7407.  
  7408.  
  7409.  
  7410.  
  7411.  
  7412.  
  7413.  
  7414.  
  7415.  
  7416.  
  7417.  
  7418.  
  7419.  
  7420.  
  7421.  
  7422.  
  7423.  
  7424.  
  7425.  
  7426.  
  7427.  
  7428.  
  7429.  
  7430.  
  7431.  
  7432.  
  7433.  
  7434.  
  7435.  
  7436.  
  7437.  
  7438.  
  7439.  
  7440.  
  7441.  
  7442.  
  7443.  
  7444.  
  7445.  
  7446.  
  7447.  
  7448.  
  7449.  
  7450.  
  7451.  
  7452.  
  7453.  
  7454.  
  7455.           Page 108
  7456.  
  7457.  
  7458.  
  7459.  
  7460.  
  7461.  
  7462.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7463.  
  7464.  
  7465.  
  7466.  
  7467.  
  7468.  
  7469.  
  7470.  
  7471.                                      Appendix A
  7472.  
  7473.                               VT100 Control Characters
  7474.  
  7475.  
  7476.                   These  appendices describe the internal operation of  PC-
  7477.           VT. They show the various control characters and escape sequences
  7478.           which PC-VT interprets as commands.  The  character  "ESC"  is an
  7479.           ASCII  control  character  with the decimal value  of  27.  These
  7480.           appendices can be skipped if your only use of PC-VT is  simply as
  7481.           a VT100 Video Terminal.
  7482.  
  7483.                   ASCII codes from 0 to  31 and 127 are control characters.
  7484.           PC-VT responds to these characters  as  listed  in  the following
  7485.           table.
  7486.  
  7487.           Name            Code            Function
  7488.  
  7489.           Null            0       This character is ignored. It can be
  7490.                                   used as a fill character. A fill
  7491.                                   character is sometimes used to take
  7492.                                   up space in a messages for timing
  7493.                                   reasons.
  7494.  
  7495.           End of Text     3       Not supported. PC-VT ignores this
  7496.                                   character.
  7497.  
  7498.           End of          4       This  character  can  be  selected  as  a
  7499.           Transmission disconnect character by the SETUP B
  7500.                                   frame. If selected, its receipt
  7501.                                   causes PC-VT to disconnect from the
  7502.                                   communications line by sending a Break.
  7503.  
  7504.           Enquire         5       Causes PC-VT to transmit its answerback
  7505.                                   message. The answerback back message is
  7506.                                   set in the SETUP B frame.
  7507.  
  7508.           Bell            7       Causes PC-VT to beep the IBM PC speaker.
  7509.  
  7510.           Backspace       8       Causes PC-VT to move the cursor back one
  7511.                                   column and delete the character there.
  7512.                                   If the cursor is already in column 1,
  7513.                                   this character is ignored.
  7514.  
  7515.           Horizontal Tab  9       Causes PC-VT to move the cursor to the
  7516.                                   next tab stop. If there are no tab stops
  7517.                                   between the current cursor position and
  7518.                                   column 80, the cursor is moved to column
  7519.  
  7520.  
  7521.                                                                    Page 109
  7522.  
  7523.  
  7524.  
  7525.  
  7526.  
  7527.  
  7528.           Appendix A                                            PC-VT v10.0
  7529.  
  7530.  
  7531.                                   80. The tab stops are set in
  7532.                                   the SETUP A frame.
  7533.  
  7534.           Line Feed       10      Causes the cursor to move down one
  7535.                                   line in the current column. If the
  7536.                                   cursor moves below the screen output
  7537.                                   area, the lines above the cursor move up
  7538.                                   one line, and a blank line is added to
  7539.                                   the bottom of the screen. The operation
  7540.                                   of this key is modified by the Line Feed/
  7541.                                   New Line feature selected in SETUP B.
  7542.  
  7543.           Vertical Tab    11      Handled as a line feed.
  7544.  
  7545.           Form Feed       12      Handled as a line feed except when being
  7546.                                   sent to a line printer via one of the
  7547.                                   print commands. It those cases, it is
  7548.                                   sent to the line printer as a Form
  7549.                                   Feed.
  7550.  
  7551.           Carriage Return 13      The cursor is moved back to the left
  7552.                                   margin. Cursor remains in the current
  7553.                                   line.
  7554.  
  7555.           Shift Out       14      Causes PC-VT to change its character set
  7556.                                   to the G0 character set. The G0 character
  7557.                                   set is selected by the Select Character
  7558.                                   Set escape sequence.
  7559.  
  7560.           Shift In        15      Causes PC-VT to change its character set
  7561.                                   to the G1 character set. The G1 character
  7562.                                   set is selected by the Select Character
  7563.                                   Set escape sequence.
  7564.  
  7565.           XON (Device     17      Causes  PC-VT  to  continue  or   restart
  7566.           Control 1) sending characters.
  7567.  
  7568.           XOFF (Device    19      Causes PC-VT to stop transmitting Control
  7569.           3) characters. It does not stop PC-VT
  7570.                                   from sending XON or XOFF.
  7571.  
  7572.           Cancel          24      Causes PC-VT to interrupt and cancel any
  7573.                                   in process escape control sequence.
  7574.                                   If received during the parsing of
  7575.                                   an escape sequence, it cancels the
  7576.                                   sequence without notification.
  7577.  
  7578.           Substitute      26      Handled as Cancel. If received during
  7579.                                   the parsing of an escape sequence, it
  7580.                                   cancels the sequence and displays an
  7581.                                   upsidedown question mark. It is also
  7582.                                   used as an End of File indicator
  7583.                                   during ASCII file transfers.
  7584.  
  7585.  
  7586.  
  7587.           Page 110
  7588.  
  7589.  
  7590.  
  7591.  
  7592.  
  7593.  
  7594.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7595.  
  7596.  
  7597.           Escape          27      Indicates the start of a special escape
  7598.                                   control sequence. If received during
  7599.                                   the parsing of an escape sequence, it
  7600.                                   cancels the sequence without
  7601.                                   notification.
  7602.  
  7603.           Delete          127     This character is ignored when received.
  7604.  
  7605.                   All other control characters are ignored.
  7606.  
  7607.  
  7608.  
  7609.  
  7610.  
  7611.  
  7612.  
  7613.  
  7614.  
  7615.  
  7616.  
  7617.  
  7618.  
  7619.  
  7620.  
  7621.  
  7622.  
  7623.  
  7624.  
  7625.  
  7626.  
  7627.  
  7628.  
  7629.  
  7630.  
  7631.  
  7632.  
  7633.  
  7634.  
  7635.  
  7636.  
  7637.  
  7638.  
  7639.  
  7640.  
  7641.  
  7642.  
  7643.  
  7644.  
  7645.  
  7646.  
  7647.  
  7648.  
  7649.  
  7650.  
  7651.  
  7652.  
  7653.                                                                    Page 111
  7654.  
  7655.  
  7656.  
  7657.  
  7658.  
  7659.  
  7660.           Appendix A                                            PC-VT v10.0
  7661.  
  7662.  
  7663.  
  7664.  
  7665.  
  7666.  
  7667.  
  7668.  
  7669.  
  7670.  
  7671.  
  7672.  
  7673.  
  7674.  
  7675.  
  7676.  
  7677.  
  7678.  
  7679.  
  7680.  
  7681.  
  7682.  
  7683.  
  7684.  
  7685.  
  7686.  
  7687.  
  7688.  
  7689.  
  7690.  
  7691.  
  7692.  
  7693.  
  7694.  
  7695.  
  7696.  
  7697.  
  7698.  
  7699.  
  7700.  
  7701.  
  7702.  
  7703.  
  7704.  
  7705.  
  7706.  
  7707.  
  7708.  
  7709.  
  7710.  
  7711.  
  7712.  
  7713.  
  7714.  
  7715.  
  7716.  
  7717.  
  7718.  
  7719.           Page 112
  7720.  
  7721.  
  7722.  
  7723.  
  7724.  
  7725.  
  7726.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7727.  
  7728.  
  7729.  
  7730.  
  7731.  
  7732.  
  7733.  
  7734.  
  7735.                                      Appendix B
  7736.  
  7737.                            VT100 Received Escape Sequences
  7738.  
  7739.  
  7740.  
  7741.  
  7742.                   PC-VT constantly monitors the communications line for the
  7743.           incoming escape sequences listed below. When  they  are received,
  7744.           PC-VT performs the function  as  shown.  The escape character and
  7745.           the characters which follow  it  and are part of the sequence are
  7746.           not displayed. When receiving (downloading) an ASCII  file, PC-VT
  7747.           copies  these  characters  to the PC disk file being created. The
  7748.           escape  character  is  shown below as  "ESC"  and  is  the  ASCII
  7749.           character with the value of 27.
  7750.  
  7751.                   Many  of  the  sequences  listed  are  extensions  to the
  7752.           standard VT100 and VT102  ANSI  escape  sequences.  Those include
  7753.           color support,  direct  control  of  PC-VT  using  private escape
  7754.           sequences, the 'Insert Character - ESC[Pn@' sequence,  the Device
  7755.           Status Report:Error sequence and keyboard redefinition sequences.
  7756.  
  7757.  
  7758.           Keypad Character Selection
  7759.  
  7760.           ESC =          Select  Alternate Keypad Mode - Sets the  keyboard
  7761.                          to transmit the  Alternate Keypad set of character
  7762.                          codes.
  7763.  
  7764.           ESC >          Select Numeric Keypad Mode - Sets the  keyboard to
  7765.                          transmit  the  Numeric  Keypad  set  of  character
  7766.                          codes.
  7767.  
  7768.           Select Character Sets
  7769.  
  7770.           ESC ( A        Select U.K. Character Set as G0 - The standard IBM
  7771.                          PC character  set is selected for ASCII codes 0 to
  7772.                          34 and 36 to 127. ASCII code 35 is replaced by the
  7773.                          extended character 156, the UK Pound sign.
  7774.  
  7775.           ESC ( B        Select U.S. Character Set as G0 - The standard IBM
  7776.                          PC character  set is selected for ASCII codes 0 to
  7777.                          127.
  7778.  
  7779.           ESC ( 0        Select Special Characters  and Line Drawing Set as
  7780.                          G0 - A  special  character and line drawing set is
  7781.                          selected. The  set  is  identical  to  the  IBM PC
  7782.  
  7783.  
  7784.  
  7785.                                                                    Page 113
  7786.  
  7787.  
  7788.  
  7789.  
  7790.  
  7791.  
  7792.           Appendix B                                            PC-VT v10.0
  7793.  
  7794.  
  7795.                          character set for ASCII codes 0 to 95. ASCII codes
  7796.                          96 to 127 are shown below.
  7797.  
  7798.           ESC ) A        Select U.K. Character Set as G1- The  standard IBM
  7799.                          PC character  set is selected for ASCII codes 0 to
  7800.                          34 and 36 to 127. ASCII code 35 is replaced by the
  7801.                          extended character 156, the UK Pound sign.
  7802.  
  7803.           ESC ) B        Select U.S. Character Set as G1 - The standard IBM
  7804.                          PC character  set is selected for ASCII codes 0 to
  7805.                          127.
  7806.  
  7807.           ESC ) 0        Select Special Characters  and Line Drawing Set as
  7808.                          G1 - A  special  character and line drawing set is
  7809.                          selected. The  set  is  identical  to  the  IBM PC
  7810.                          character set for ASCII codes 0 to 95. ASCII codes
  7811.                          96 to 127 are shown below.
  7812.  
  7813.  
  7814.  
  7815.  
  7816.  
  7817.  
  7818.  
  7819.  
  7820.  
  7821.  
  7822.  
  7823.  
  7824.  
  7825.  
  7826.  
  7827.  
  7828.  
  7829.  
  7830.  
  7831.  
  7832.  
  7833.  
  7834.  
  7835.  
  7836.  
  7837.  
  7838.  
  7839.  
  7840.  
  7841.  
  7842.  
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.  
  7850.  
  7851.           Page 114
  7852.  
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7859.  
  7860.  
  7861.           Special Character and Line Drawing Set
  7862.  
  7863.           ASCII Code      Character               IBM PC ASCII Code
  7864.  
  7865.           0 - 95          Same as the standard IBM PC character set.
  7866.           96              Diamond                           4
  7867.           97              Large Block                     219
  7868.           98              Horizontal Tab (right arrow)     26
  7869.           99              Formfeed (up triangle)           30
  7870.           100             Carriage Return (left arrow)     27
  7871.           101             Linefeed (up arrow)              24
  7872.           102             Degree Symbol                   248
  7873.           103             Plus/Minus Sign                 241
  7874.           104             New Line (down arrow)            25
  7875.           105             Vertical Tab (up/down arrow)     23
  7876.           106             Upper Right Corner              217
  7877.           107             Lower Right Corner              191
  7878.           108             Lower Left Corner               218
  7879.           109             Upper Left Corner               192
  7880.           110             Crossing Lines                  197
  7881.           111             Horizontal Line                 196
  7882.           112             Horizontal Line                 196
  7883.           113             Horizontal Line                 196
  7884.           114             Horizontal Line                 196
  7885.           115             Horizontal Line                 196
  7886.           116             Left T                          195
  7887.           117             Right T                         180
  7888.           118             Top T                           193
  7889.           119             Bottom T                        194
  7890.           120             Vertical Line                   179
  7891.           121             Less Than or Equal To           243
  7892.           122             Greater Than or Equal           242
  7893.           123             Pi Symbol                        20
  7894.           124             Not Equal Sign (squiggle)       247
  7895.           125             UK Pound Sign                   156
  7896.           126             Centered Dot                    250
  7897.           127             blank                            32
  7898.  
  7899.  
  7900.           Display Attributes
  7901.  
  7902.           ESC [ m        Select   Graphic   Rendition  -   Resets   Display
  7903.                          Attribute to default per SETUP B display.
  7904.  
  7905.           ESC [ 0 m      Same as "ESC [ m".
  7906.  
  7907.           ESC [ 1 m      Select Graphic Rendition - Sets  Display Attribute
  7908.                          to bold. PC-VT does not support  bold  and reverse
  7909.                          video concurrently.
  7910.  
  7911.           ESC [ 4 m      Select Graphic Rendition - Sets  Display Attribute
  7912.                          to  underline  (IBM  Monochrome Display only). For
  7913.                          the  Color  Graphics  Adapter, PC-VT displays this
  7914.                          attribute as bold or bold & blinking so that it is
  7915.  
  7916.  
  7917.                                                                    Page 115
  7918.  
  7919.  
  7920.  
  7921.  
  7922.  
  7923.  
  7924.           Appendix B                                            PC-VT v10.0
  7925.  
  7926.  
  7927.                          recognizable. The  attribute  is  selected  in the
  7928.                          SETUP B frame. PC-VT  does  not  support underline
  7929.                          and reverse video concurrently.
  7930.  
  7931.           ESC [ 5 m      Select Graphic Rendition - Sets  Display Attribute
  7932.                          to blink.
  7933.  
  7934.           ESC [ 7 m      Select Graphic Rendition - Sets  Display Attribute
  7935.                          to reverse video. PC-VT does not support underline
  7936.                          or bold and reverse video concurrently.
  7937.  
  7938.                          Bold does not appear when the screen is in reverse
  7939.                          video. This is a limitation  of  the  PC hardware.
  7940.                          Underline appears in  reverse video since the same
  7941.                          bits in the hardware attribute are used to control
  7942.                          those two modes.
  7943.  
  7944.                          The  other  modes   are  additive.  That  is,  The
  7945.                          sequence "ESC [ 7 m  ESC [ 5 m" produces blinking,
  7946.                          high intensity video. Then "ESC  [  m"  resets the
  7947.                          display to the default, usually white on black.
  7948.  
  7949.                          PC-VT supports multiple parameters for  the Select
  7950.                          Graphic Rendition sequence. For example, the three
  7951.                          sequences  in the previous paragraph can be  coded
  7952.                          as "ESC [ 7 ; 5 ; 1 m". Up to 14 parameters may be
  7953.                          specified.
  7954.  
  7955.                          Figure B.1 shows what you will see on a Monochrome
  7956.                          monitor.  With  the CGA monitor  the  results  are
  7957.                          similar depending on  what selection you have made
  7958.                          for underline in the SETUP B frame.
  7959.  
  7960.  
  7961.  
  7962.  
  7963.  
  7964.  
  7965.  
  7966.  
  7967.  
  7968.  
  7969.  
  7970.  
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.  
  7983.           Page 116
  7984.  
  7985.  
  7986.  
  7987.  
  7988.  
  7989.  
  7990.           PC-VT v10.0                                 VT100 & 4014 Emulator
  7991.  
  7992.  
  7993.  
  7994.  
  7995.           ---------------------------------------------------------------------------
  7996.  
  7997.           Screen in White on Black Mode
  7998.  
  7999.           Attribute:
  8000.                   Under                                   Screen
  8001.           Normal  Line    Blink   Reverse Bold            Displays
  8002.           x                                               Normal Video
  8003.           x       x                                       Underline Normal Video
  8004.           x               x                               Blink Normal Video
  8005.           x       x       x                               Underline Blink Normal
  8006.           Video
  8007.                                   x                       Negative Video
  8008.                   x               x                       *Negative Video
  8009.                           x       x                       Blink Negative Video
  8010.                   x       x       x                       *Blink Negative Video
  8011.  
  8012.                                           x               Bold Video
  8013.                   x                       x               Underline Bold Video
  8014.                           x               x               Blink Bold Video
  8015.                   x       x               x               Underline Blink Bold Video
  8016.                                   x       x               *Negative Video
  8017.                   x               x       x               *Negative Video
  8018.                           x       x       x               *Blink Negative Video
  8019.                   x       x       x       x               *Blink Negative Video
  8020.  
  8021.  
  8022.           Asterisks indicate modes which are not exactly like the VT100.
  8023.  
  8024.  
  8025.                   Figure B.1 PC-VT Video Attribute Handling
  8026.  
  8027.  
  8028.  
  8029.           ---------------------------------------------------------------------------
  8030.  
  8031.  
  8032.  
  8033.  
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.  
  8042.  
  8043.  
  8044.  
  8045.  
  8046.  
  8047.  
  8048.  
  8049.                                                                    Page 117
  8050.  
  8051.  
  8052.  
  8053.  
  8054.  
  8055.  
  8056.           Appendix B                                            PC-VT v10.0
  8057.  
  8058.  
  8059.  
  8060.  
  8061.           ---------------------------------------------------------------------------
  8062.  
  8063.  
  8064.           Screen in Black on White Mode
  8065.           Attribute:
  8066.                   Under                                   Screen
  8067.           Normal  Line    Blink   Reverse Bold            Displays
  8068.           x                                               Negative Video
  8069.           x       x                                       *Normal Video
  8070.           x               x                               Blink Negative Video
  8071.           x       x       x                               *Blink Normal Video
  8072.                                   x                       Normal Video
  8073.                   x               x                       *Normal Video
  8074.                           x       x                       Blink Normal Video
  8075.                   x       x       x                       *Blink Normal Video
  8076.  
  8077.                                           x               *Negative Video
  8078.                   x                       x               *Normal Video
  8079.                           x               x               *Blink Negative Video
  8080.                   x       x               x               *Blink Normal Video
  8081.                                   x       x               *Normal Bold Video
  8082.                   x               x       x               *Normal Bold Video
  8083.                           x       x       x               *Blink Bold Normal Video
  8084.                   x       x       x       x               *Blink Bold Normal Video
  8085.  
  8086.  
  8087.           Asterisks indicate modes which are not exactly like the VT100.
  8088.  
  8089.                   Figure B.1 (continued) PC-VT Video Attribute Handling
  8090.  
  8091.  
  8092.  
  8093.           ---------------------------------------------------------------------------
  8094.  
  8095.  
  8096.  
  8097.  
  8098.  
  8099.  
  8100.  
  8101.  
  8102.  
  8103.  
  8104.  
  8105.  
  8106.  
  8107.  
  8108.  
  8109.  
  8110.  
  8111.  
  8112.  
  8113.  
  8114.  
  8115.           Page 118
  8116.  
  8117.  
  8118.  
  8119.  
  8120.  
  8121.  
  8122.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8123.  
  8124.  
  8125.  
  8126.           Color
  8127.  
  8128.                          PC-VT  can  handle  color if you are  on  a  color
  8129.                          monitor.  The  color  must  be  set  by  the  host
  8130.                          computer.
  8131.  
  8132.           ESC [ Pc m     Select Graphic Rendition - Sets  Display Attribute
  8133.                          to  the  color  given by Pc as follows (Pc must be
  8134.                          sent as 1 or 2 ASCII characters):
  8135.  
  8136.                          8               Invisible
  8137.                          30              Black Foreground
  8138.                          31              Red Foreground
  8139.                          32              Green Foreground
  8140.                          33              Yellow Foreground
  8141.                          34              Blue Foreground
  8142.                          35              Magenta Foreground
  8143.                          36              Cyan Foreground
  8144.                          37              White Foreground
  8145.                          40              Black Background
  8146.                          41              Red Background
  8147.                          42              Green Background
  8148.                          43              Yellow Background
  8149.                          44              Blue Background
  8150.                          45              Magenta Background
  8151.                          46              Cyan Background
  8152.                          47              White Background
  8153.  
  8154.  
  8155.                          Example   to   set   red   characters  on  a  blue
  8156.                          background:
  8157.  
  8158.                          ESC [ 3 1 m ESC [ 4 4 m ESC [ 2 J ESC [7 H
  8159.  
  8160.                          Where ESC is the escape character ASCII 27.
  8161.  
  8162.                          Note that setting the colors does  not  affect the
  8163.                          current  contents of the display. Only  characters
  8164.                          displayed  following  the  color setting sequences
  8165.                          are in color. This is  consistent  with  the other
  8166.                          Select  Graphic Rendition sequences. To clear  the
  8167.                          screen to the new background color, use  the clear
  8168.                          screen  sequence  followed  by  the   home  cursor
  8169.                          sequence.  By just using the color sequences,  you
  8170.                          can  display portions of your output in  different
  8171.                          colors.
  8172.  
  8173.                          Certain   of   these  combinations,   like   black
  8174.                          foreground characters on a black background, won't
  8175.                          show anything on the display.
  8176.  
  8177.                          The  colors  which   you  select  become  the  new
  8178.                          temporary defaults for PC-VT. That is, if  you set
  8179.  
  8180.  
  8181.                                                                    Page 119
  8182.  
  8183.  
  8184.  
  8185.  
  8186.  
  8187.  
  8188.           Appendix B                                            PC-VT v10.0
  8189.  
  8190.  
  8191.                          up white on blue and  send the "ESC [ m" sequence,
  8192.                          the color is reset to the defaults which are white
  8193.                          on blue. If  you  want to return to standard white
  8194.                          characters on a black  background,  you  must send
  8195.                          "ESC [ 3 7 m ESC [ 4 0 m".
  8196.  
  8197.                          To make the selected colors permanent for the next
  8198.                          time  you  run  PC-VT, go to the SETUP A frame and
  8199.                          select the "s" store option.
  8200.  
  8201.           Scrolling Margin
  8202.  
  8203.           ESC [ Pt ; Pb r
  8204.                          Sets  top  and  bottom  scrolling  margins  -  The
  8205.                          scrolling region includes  display  lines starting
  8206.                          at Pt and ending at Pb inclusive. Pt  and  Pb must
  8207.                          be  between  1  and 24. Pb must be greater than or
  8208.                          equal to Pt. If Pt is omitted, it  defaults  to 1.
  8209.                          If Pb is omitted, it defaults to 24.
  8210.  
  8211.           Cursor Movement Commands
  8212.  
  8213.           ESC [ Pn A     Cursor Up  - Moves cursor up Pn lines. If omitted,
  8214.                          Pn is assumed to be 1. If the cursor is already at
  8215.                          the top of the screen, this  sequence  is ignored.
  8216.                          If Pn is  greater than the number of lines  to the
  8217.                          top of the screen, the  cursor is moved to the top
  8218.                          of the screen.
  8219.  
  8220.           ESC [ Pn B     Cursor Down  -  Moves  cursor  down  Pn  lines. If
  8221.                          omitted, Pn is assumed to be 1. If  the  cursor is
  8222.                          already at the bottom of the screen, this sequence
  8223.                          is ignored. If Pn is  greater than  the  number of
  8224.                          lines to the  bottom  of the screen, the cursor is
  8225.                          moved to the bottom of the screen.
  8226.  
  8227.           ESC [ Pn C     Cursor Right - Moves cursor right  Pn  columns. If
  8228.                          omitted, Pn is assumed to be 1. If  the  cursor is
  8229.                          already at the right margin  of  the  screen, this
  8230.                          sequence is ignored. If  Pn  is   greater than the
  8231.                          number of  columns  to  the  right  margin  of the
  8232.                          screen, the cursor is moved to the right margin of
  8233.                          the screen.
  8234.  
  8235.           ESC [ Pn D     Cursor Left - Moves  cursor  left  Pn  columns. If
  8236.                          omitted, Pn is assumed to be 1. If  the  cursor is
  8237.                          already at the left  margin  of  the  screen, this
  8238.                          sequence is ignored. If  Pn  is   greater than the
  8239.                          number  of  columns  to  the  left  margin  of the
  8240.                          screen, the  cursor is moved to the left margin of
  8241.                          the screen.
  8242.  
  8243.  
  8244.  
  8245.  
  8246.  
  8247.           Page 120
  8248.  
  8249.  
  8250.  
  8251.  
  8252.  
  8253.  
  8254.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8255.  
  8256.  
  8257.           ESC [ Pl ; Pc H
  8258.                          Cursor  Position  -  Moves  the cursor to absolute
  8259.                          line given by  Pl and absolute column given by Pc.
  8260.                          Pl must be between 1 and 24. Pc must be  between 1
  8261.                          and 80. If omitted, Pl and Pc are assumed to be 1.
  8262.  
  8263.           ESC [ Pl ; Pc f
  8264.                          Same as "ESC [ Pl ; Pc H".
  8265.  
  8266.           ESC H          Cursor Position (Home) - Move  the  cursor  to the
  8267.                          top left  of the screen. Same as the sequence "ESC
  8268.                          [ 1 ; 1 H" or "ESC [ 1 ; 1 f".
  8269.  
  8270.           ESC [ f        Same as "ESC H".
  8271.  
  8272.           ESC D          Index - Moves the cursor down one line. The cursor
  8273.                          remains  in  the  same  column.  A  scroll  up  is
  8274.                          performed if the cursor moves below line 24.
  8275.  
  8276.           ESC M          Reverse Index  - Moves the cursor up one line. The
  8277.                          cursor remains in the same column.  A  scroll down
  8278.                          is performed if the cursor moves above line 1.
  8279.  
  8280.           ESC E          Next Line -  Moves  the cursor to the first column
  8281.                          of the  next line. A scroll up is performed if the
  8282.                          cursor moves below line 24.
  8283.  
  8284.           ESC 7          Save cursor - Saves  the  current  cursor position
  8285.                          (line,column),   display    character   attribute,
  8286.                          selected character set, and origin mode.
  8287.  
  8288.           ESC 8          Restore Cursor -  Restores the cursor position and
  8289.                          other  saved attributes to the values recorded  by
  8290.                          the last "ESC [  7"  sequence.  If the save cursor
  8291.                          escape sequence has  not been received since PC-VT
  8292.                          was started, no values are restored and the cursor
  8293.                          is moved to the top left margin.
  8294.  
  8295.           Line Attributes
  8296.  
  8297.           ESC # 3 and ESC # 4
  8298.                          Double  Height  Line,  Top  Half and Double Height
  8299.                          Line, Bottom  Half  -  These  two  sequences  must
  8300.                          always be used in pairs on adjacent  lines. Double
  8301.                          height lines are simulated  in  PC-VT  by blanking
  8302.                          the top line and converting the  bottom  line into
  8303.                          double width  by taking the left half of the line,
  8304.                          inserting  blanks  between   the   characters  and
  8305.                          placing them back down to occupy the  entire line.
  8306.                          Any characters on  the  right half of the line are
  8307.                          lost.
  8308.  
  8309.           ESC # 5        Single Width Line - Converts the current line into
  8310.                          a single  width  line.  PC-VT  simulates  this  by
  8311.  
  8312.  
  8313.                                                                    Page 121
  8314.  
  8315.  
  8316.  
  8317.  
  8318.  
  8319.  
  8320.           Appendix B                                            PC-VT v10.0
  8321.  
  8322.  
  8323.                          taking  every  other  character  from the line and
  8324.                          putting them down in  the  left  half of the line.
  8325.                          The right half of the line is blanked.
  8326.  
  8327.           ESC # 6        Double Width Line - Converts the current line into
  8328.                          simulated  double  width  characters by taking the
  8329.                          left half of the  line,  inserting  blanks between
  8330.                          the characters  and  placing  them  back  down  to
  8331.                          occupy  the  entire line. Any  characters  on  the
  8332.                          right  half  of  the  line  are  lost.  The cursor
  8333.                          remains in the  same character position unless the
  8334.                          cursor would  have  moved  off  the  right  of the
  8335.                          screen. In  that case, the cursor is placed at the
  8336.                          right margin.
  8337.  
  8338.           Tab Stops
  8339.  
  8340.           ESC H          Horizontal  Tab  Set  - Clear a tab  stop  at  the
  8341.                          column position occupied by the cursor.
  8342.  
  8343.           ESC [ g        Tabulation Clear  - Clears the tab, if any, at the
  8344.                          column position occupied by the cursor.
  8345.  
  8346.           ESC [ 0 g      Same as "ESC [ g".
  8347.  
  8348.           ESC [ 3 g      Tabulation Clear - Clears all tabs.
  8349.  
  8350.           Editing Functions
  8351.  
  8352.           ESC [ Pn @     Insert Character - Inserts Pn  characters starting
  8353.                          at the cursor  position. Character(s) to the right
  8354.                          of the cursor column move right.  Pn,  if omitted,
  8355.                          is assumed to be  1.  Character(s)  moved  off the
  8356.                          right of the display are lost.
  8357.  
  8358.           ESC [ Pn P     Delete Character - Deletes Pn  characters starting
  8359.                          at the cursor position. Characters to the right of
  8360.                          the   deleted  character(s)  move  left.  Pn,   if
  8361.                          omitted, is assumed to be 1.  Spaces  are inserted
  8362.                          at the right as needed.
  8363.  
  8364.           ESC [ Pn L     Insert Line - Inserts  Pn  lines  before  the line
  8365.                          containing cursor. The  current line and all lines
  8366.                          below it move down the display.  Lines  which move
  8367.                          below the bottom scrolling margin are lost. Pn, if
  8368.                          omitted, is assumed to be 1.
  8369.  
  8370.           ESC [ Pn M     Delete Line - Deletes  Pn  lines  starting  at the
  8371.                          line containing the  cursor and below. Lines below
  8372.                          the deleted lines move  up.  New  blank  lines are
  8373.                          created to fill the bottom of the  scrolling area.
  8374.                          If omitted, Pn is assumed to be 1.
  8375.  
  8376.           Erasing
  8377.  
  8378.  
  8379.           Page 122
  8380.  
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8387.  
  8388.  
  8389.           ESC [ K        Erase In Line -  Erases  the  line occupied by the
  8390.                          cursor from the cursor to the end of the Line.
  8391.  
  8392.           ESC [ 0 K      Same as "ESC [ K".
  8393.  
  8394.           ESC [ 1 K      Erase In Line -  Erases  the  line occupied by the
  8395.                          cursor from  the  beginning  of  the  line  to the
  8396.                          cursor.
  8397.  
  8398.           ESC [ 2 K      Erase In Line - Erases the entire  line containing
  8399.                          the cursor.
  8400.  
  8401.           ESC [ J        Erase In Display  -  Erases  the  screen  from the
  8402.                          current cursor position to the bottom left  of the
  8403.                          display.
  8404.  
  8405.           ESC [ 0 J      Same as "ESC [ J".
  8406.  
  8407.           ESC [ 1 J      Erase In  Display - Erases the screen from the top
  8408.                          right  of  the   display  to  the  current  cursor
  8409.                          position.
  8410.  
  8411.           ESC [ 2 J      Erase In Display - Erases the entire screen.
  8412.  
  8413.           Print Commands
  8414.  
  8415.                          These commands are ignored if there is no printer
  8416.                          attached to the PC or if
  8417.                          the printer is not ready. LPT1 or LPT2 is selected
  8418.                          on the SETUP B frame. In
  8419.                          the normal VT100 definition, any formfeed
  8420.                          characters are translated to
  8421.                          linefeed characters before they are displayed. PC-
  8422.                          VT does not translate
  8423.                          formfeeds which are routed the printer.
  8424.  
  8425.                          If  a  printer  error  occurs, the escape sequence
  8426.                          "ESC [ ? 10 n"  returns the error code.
  8427.  
  8428.           ESC [ ? 5 i    Media Copy - Turn on  Auto  Print.  All characters
  8429.                          locally or echoed  by  the host are printed on the
  8430.                          selected  printer,  if   present,  as  soon  as  a
  8431.                          carriage return is  received. The character 'P' is
  8432.                          displayed in column 42 of the Status Line (line 25
  8433.                          ) of  the display to indicate that printer echo is
  8434.                          turned on.
  8435.  
  8436.           ESC [ ? 4 i    Media Copy - Turns off Auto Print.
  8437.  
  8438.           ESC [ 5 i      Media  Copy  -  Turns  on  Print  Controller.  All
  8439.                          characters received from the host are displayed on
  8440.                          the selected printer, if  present,  as  soon  as a
  8441.                          carriage return is received. Nothing  is displayed
  8442.                          on the screen.
  8443.  
  8444.  
  8445.                                                                    Page 123
  8446.  
  8447.  
  8448.  
  8449.  
  8450.  
  8451.  
  8452.           Appendix B                                            PC-VT v10.0
  8453.  
  8454.  
  8455.                          When Print Controller mode is on, escape sequences
  8456.                          are not sent to  the  printer.  This  is different
  8457.                          than the strict VT  printer  definition.  The next
  8458.                          sequence  when parsed, turns off Print  Controller
  8459.                          mode.
  8460.  
  8461.           ESC [ 4 i      Media  Copy  -   Turns  off  Print  Controller.  A
  8462.                          carriage return and linefeed should be sent to the
  8463.                          selected printer before transmitting this sequence
  8464.                          to be sure that the  printer is ready for the next
  8465.                          print sequence and that the print  carriage  is at
  8466.                          the left margin.
  8467.  
  8468.           ESC [ i        Media Copy - The  screen  as  defined by the print
  8469.                          extent  in  the  SETUP B frame is  copied  to  the
  8470.                          selected  printer, if present. A formfeed is  sent
  8471.                          to the selected printer at the  conclusion  of the
  8472.                          printing  if the Termination Character feature  is
  8473.                          set in the SETUP B frame.
  8474.  
  8475.           ESC [ ? 1 i    Media Copy - The  line  containing  the  cursor is
  8476.                          printed on the selected printer, if present.
  8477.  
  8478.           ESC [ ? 3 i    Special  Print  - A PC-VT  private  sequence.  The
  8479.                          contents  of the filename download buffer is  sent
  8480.                          to the printer. Underline characters are converted
  8481.                          to the  Escape  character  (ASCII  27).  Load  the
  8482.                          buffer  with the "ESC [ ? 2 4 h" and "ESC [ ? 2  4
  8483.                          l" sequences. See Appendix J.
  8484.  
  8485.           Reports
  8486.  
  8487.           ESC [ 5 n      Device Status Report, Hardware - The status of PC-
  8488.                          VT and hardware is reported with this response:
  8489.  
  8490.                          "ESC [ 0 n "        PC-VT is OK.
  8491.  
  8492.           ESC [ ? 10 n   Device Status Report, Error - The last error which
  8493.                          occurred  is  reported.  A private PC-VT sequence.
  8494.                          Format is:
  8495.  
  8496.                          "ESC [ ? x ; y n "      Last error  or  DOS return
  8497.                          code  which occurred is returned as  x.  If  x  is
  8498.                          zero, usually no error occurred.  Termination code
  8499.                          returned by a called program is  y.  This response
  8500.                          is available  for  printer  errors,  file transfer
  8501.                          errors  and  calling  of  COMMAND.COM.  Check  the
  8502.                          technical appendix for details.
  8503.  
  8504.           ESC [ ? 15 n   Device Status Report, Printer - The status  of the
  8505.                          selected printer is reported with these responses:
  8506.  
  8507.  
  8508.  
  8509.  
  8510.  
  8511.           Page 124
  8512.  
  8513.  
  8514.  
  8515.  
  8516.  
  8517.  
  8518.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8519.  
  8520.  
  8521.                          "ESC [ ? 13 n   "       No printer on system
  8522.                          "ESC [ ? 10 n   "       Printer ready
  8523.                          "ESC [ ? 11 n   "       Printer not ready.
  8524.  
  8525.           ESC [ 6 n      Device  Status  Report,  Cursor  Position   -  The
  8526.                          position of  the  cursor  is  reported  with  this
  8527.                          response:
  8528.  
  8529.                          "ESC [ Pl ; Pc R"       The cursor is currently at
  8530.                          line Pl and column Pc.
  8531.  
  8532.           ESC [ c        Device Attribute Report - PC-VT reports that it is
  8533.                          a VT102 or  VT100 Video Terminal compatible device
  8534.                          with the responses:
  8535.  
  8536.                          "ESC [ ? 6 c"           I am a VT102
  8537.                           or
  8538.                          "ESC [ ? 1 ; 2 c"       I am a VT100 with Advanced
  8539.                          Video Option (AVO)
  8540.  
  8541.                          The  response  depends   upon  the  state  of  the
  8542.                          Terminal Type  bit in the SETUP B frame. The VT100
  8543.                          terminal response includes the AVO indication even
  8544.                          though your hardware may not support 132 columns.
  8545.  
  8546.           ESC [ 0 x      Request  Terminal  Parameters  - PC-VT reports its
  8547.                          terminal   parameters   and   enables  unsolicited
  8548.                          reporting. When unsolicited reporting is  enabled,
  8549.                          PC-VT  reports  terminal  parameters when SETUP is
  8550.                          exited (in VT100 emulation mode only).
  8551.  
  8552.           ESC [ 1 x      Request  Terminal  Parameters  - PC-VT reports its
  8553.                          terminal  parameters   and   disables  unsolicited
  8554.                          reporting.
  8555.  
  8556.                          Terminal Parameters are reported as follows :
  8557.                          "ESC [ Ps ; Pp ; Pn ; Px ; Pr ; 1 ; x"          Where
  8558.                          :
  8559.                          Ps is  2 indicating that this sequence is a report
  8560.                          or 3 indicating that this sequence is a report and
  8561.                          that unsolicited reporting is disabled,
  8562.                          Pp is 1 indicating  no  parity,  4  indicating odd
  8563.                          parity or 5 indicating even parity,
  8564.                          Pn is 1 indicating 8 data bits or  2  indicating 7
  8565.                          data bits,
  8566.                          Px and Pr (both  identical)  indicating  COM1 port
  8567.                          speed as follows:
  8568.  
  8569.  
  8570.  
  8571.  
  8572.  
  8573.  
  8574.  
  8575.  
  8576.  
  8577.                                                                    Page 125
  8578.  
  8579.  
  8580.  
  8581.  
  8582.  
  8583.  
  8584.           Appendix B                                            PC-VT v10.0
  8585.  
  8586.  
  8587.                                  Value           Speed
  8588.                                  -----           -----
  8589.                                  16              100 baud
  8590.                                  32              150 baud
  8591.                                  48              300 baud
  8592.                                  64              1200 baud
  8593.                                  88              2400 baud
  8594.                                  104             4800 baud
  8595.                                  112             9600 baud
  8596.  
  8597.           ESC [ 0 c      Same as "ESC [ c".
  8598.  
  8599.           ESC Z          Same as "ESC [ c".
  8600.  
  8601.           Reset
  8602.  
  8603.           ESC c          Reset to Initial State -  PC-VT  is  reset  to its
  8604.                          initial state by reading the USER  MEMORY  file on
  8605.                          the default drive.  The program is then restarted.
  8606.                          If a host was selected,  either  from  the command
  8607.                          line or in the  DIALER  frame,  the SETUP data for
  8608.                          that host is  reloaded.  PC-VT sends an XON to the
  8609.                          host if XON/XOFF support is selected.
  8610.  
  8611.           Tests and Adjustments
  8612.  
  8613.           ESC[ ... y     PC-VT does  not run any local tests in response to
  8614.                          these  sequences. PC-VT  just  responds  with  the
  8615.                          terminal OK response  "ESC  [ 0 n". PC-VT sends an
  8616.                          XON to the host if XON/XOFF support is selected.
  8617.  
  8618.           Keyboard LED's
  8619.  
  8620.                          Four LED's are supported in both  VT100  and VT102
  8621.                          modes.
  8622.  
  8623.           ESC [ q        Load LED  (LED's  off)  -  The  emulated  LED's on
  8624.                          Status Line 25 of the display are turned off.
  8625.  
  8626.           ESC [ 0 q      Same as "ESC [ q".
  8627.  
  8628.           ESC [ 1 q      Load LED (L1 on) - The emulated LED  L1  on Status
  8629.                          Line 25 of the display is turned on.
  8630.  
  8631.           ESC [ 2 q      Load LED (L2 on) - The emulated LED  L2  on Status
  8632.                          Line 25 of the display is turned on.
  8633.  
  8634.           ESC [ 3 q      Load LED (L3 on) - The emulated LED  L3  on Status
  8635.                          Line 25 of the display is turned on.
  8636.  
  8637.           ESC [ 4 q      Load LED (L4 on) - The emulated LED  L4  on Status
  8638.                          Line 25 of the display is turned on.
  8639.  
  8640.           VT52 Compatible Mode
  8641.  
  8642.  
  8643.           Page 126
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8651.  
  8652.  
  8653.           ESC <          Enter ANSI mode.
  8654.  
  8655.           ESC =          Enter alternate keypad mode.
  8656.  
  8657.           ESC >          Exit alternate keypad mode to numeric keypad mode.
  8658.  
  8659.           ESC F          Select special graphics character set.
  8660.  
  8661.           ESC G          Select US/UK character set.
  8662.  
  8663.           ESC A          Cursor up.
  8664.  
  8665.           ESC B          Cursor down.
  8666.  
  8667.           ESC C          Cursor right.
  8668.  
  8669.           ESC D          Cursor left.
  8670.  
  8671.           ESC H          Home cursor.
  8672.  
  8673.           ESC Y Pl Pc    Direct cursor address.
  8674.  
  8675.           ESC I          Reverse linefeed.
  8676.  
  8677.           ESC K          Erase to end of line.
  8678.  
  8679.           ESC J          Erase to end of screen.
  8680.  
  8681.           ESC ^          Enter auto print mode.
  8682.  
  8683.           ESC _          Exit auto print mode.
  8684.  
  8685.           ESC W          Enter printer controller mode.
  8686.  
  8687.           ESC X          Exit printer controller mode.
  8688.  
  8689.           ESC ]          Print screen.
  8690.  
  8691.           ESC V          Print current line.
  8692.  
  8693.           ESC Z          Identify what you are. PC-VT responds with  "ESC /
  8694.                          Z".
  8695.  
  8696.                          PC-VT   still  responds  to  DEC  private   escape
  8697.                          sequences while in VT52 compatibility mode.
  8698.  
  8699.           Set Mode
  8700.  
  8701.           ESC [ 2 h      Keyboard Action - The keyboard is locked. Pressing
  8702.                          any key causes PC-VT to  click.  The  message "KBD
  8703.                          LOCKED" is displayed  on  Status  Line  25  of the
  8704.                          screen.
  8705.  
  8706.  
  8707.  
  8708.  
  8709.                                                                    Page 127
  8710.  
  8711.  
  8712.  
  8713.  
  8714.  
  8715.  
  8716.           Appendix B                                            PC-VT v10.0
  8717.  
  8718.  
  8719.           ESC [ 4 h      Insert-replacement - Insert mode is  selected. Any
  8720.                          characters received cause the characters currently
  8721.                          on the screen  from  the  cursor  position  to the
  8722.                          right to be  moved  one position to the right. The
  8723.                          newly  received character is then inserted in  the
  8724.                          vacated space.
  8725.  
  8726.           ESC [ 12 h     Send-Receive Mode  -  Sets  host  echo. Characters
  8727.                          typed at the keyboard  are  not  locally displayed
  8728.                          unless they are sent back by the host.
  8729.  
  8730.           ESC [ 20 h     Linefeed /  New Line - Sets PC-VT to transmit both
  8731.                          a carriage return and linefeed when the  ENTER key
  8732.                          is pressed. Causes received linefeed, formfeed and
  8733.                          vertical tab characters to move the cursor  to the
  8734.                          left margin of the next line.
  8735.  
  8736.           ESC [ ? 1 h    Cursor Key -  Sets  the  cursor  keys  to generate
  8737.                          Application  Mode  functions.  For the VT102, this
  8738.                          sequence is valid only in Application Keypad mode.
  8739.                          For the VT100, it is valid anytime.
  8740.  
  8741.           ESC [ ? 5 h    Screen - Sets the screen  to  reverse  video mode.
  8742.                          The display attribute is set  to  black  on white.
  8743.                          The entire display is flipped to  black  on white.
  8744.                          All   characters received after this sequence  are
  8745.                          displayed in black on white.
  8746.  
  8747.           ESC [ ? 6 h    Origin - Sets the  home  position  to the top left
  8748.                          margin of the scrolling region set by the "Set top
  8749.                          and bottom margins" sequence "ESC [ Pt ; Pb r" .
  8750.  
  8751.           ESC [ ? 7 h    Autowrap - Sets autowrap on. When the  cursor gets
  8752.                          to the  right  margin  and  another  character  is
  8753.                          received, a carriage  return and linefeed are sent
  8754.                          to the display.
  8755.  
  8756.           ESC [ ? 8 h    Autorepeat -  Sets  autorepeat  on.  This  is  the
  8757.                          normal operation  of the IBM PC keyboard. If a key
  8758.                          is held down, it  starts  to  repeatedly  send its
  8759.                          code to the running program. This  is  the default
  8760.                          setting for PC-VT.
  8761.  
  8762.           ESC [ ? 18 h   Print Formfeed  On - PC-VT sends a formfeed to the
  8763.                          selected  printer  at the conclusion  of  a  print
  8764.                          screen operation. This is the default setting.
  8765.  
  8766.           ESC [ ? 19 h   Print Extent -  The  full screen is printed on the
  8767.                          selected printer  by  the  print  screen sequence.
  8768.                          This is the default setting.
  8769.  
  8770.           ESC [ ? 21 h   Receive File - Performs the same  function  as the
  8771.                          CTRL-F3 key on  the keyboard. PC-VT private. Error
  8772.  
  8773.  
  8774.  
  8775.           Page 128
  8776.  
  8777.  
  8778.  
  8779.  
  8780.  
  8781.  
  8782.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8783.  
  8784.  
  8785.                          code  is  available  with the "ESC  [  ?  1  0  n"
  8786.                          sequence. See Appendix J.
  8787.  
  8788.           ESC [ ? 22 h   Transmit File - Performs the same function  as the
  8789.                          CTRL-F4 key on  the keyboard. PC-VT private. Error
  8790.                          code  is  available  with the "ESC  [  ?  1  0  n"
  8791.                          sequence. See Appendix J.
  8792.  
  8793.           ESC [ ? 23 h   Special Sequence - This escape sequence causes PC-
  8794.                          VT to send a carriage return to the host. This was
  8795.                          implemented as a debug feature. PC-VT private. See
  8796.                          Appendix J.
  8797.  
  8798.           ESC [ ? 24 h   Set Buffer Load -  The  buffer  load  operation is
  8799.                          started. PC-VT private. See Appendix J.
  8800.  
  8801.           ESC [ ? 25 h   Change  Directory - Performs the same function  as
  8802.                          the CTRL-F2 key on  the  keyboard.  PC-VT private.
  8803.                          Error code is available  with  the "ESC [ ? 1 0 n"
  8804.                          sequence. See Appendix J
  8805.  
  8806.           ESC [ ? 26 h   Terminate PC-VT - Performs  the  same  function as
  8807.                          the CTRL-F8 key on  the  keyboard.  PC-VT private.
  8808.                          See Appendix J.
  8809.  
  8810.           ESC [ ? 27 h   Start Up Command.com  - Performs the same function
  8811.                          as the ALT-F key on the  keyboard.  PC-VT private.
  8812.                          Error code is available  with  the "ESC [ ? 1 0 n"
  8813.                          sequence. See Appendix J.
  8814.  
  8815.           ESC [ ? 28 h   Select EVE  editor  keypad  support.  Performs the
  8816.                          same function  as setting the EVE bit in the SETUP
  8817.                          B frame. PC-VT private. See Appendix J.
  8818.  
  8819.           ESC [ ? 29 h   Select VMS Operating System support.  Performs the
  8820.                          same function  as setting the VMS bit in the SETUP
  8821.                          B frame. PC-VT private. See Appendix J.
  8822.  
  8823.           ESC [ ? 38 h   Switch to the 4014 emulator. This  sequence  is an
  8824.                          extension based on the DEC VT240. The PC must have
  8825.                          an IBM Color Graphics Adapter, a Hercules Graphics
  8826.                          Card or  an Everex Edge Card or else this sequence
  8827.                          is ignored.
  8828.  
  8829.           Reset Mode
  8830.  
  8831.           ESC [ 2 l      Keyboard  Action - Unlocks the keyboard.  Pressing
  8832.                          any key causes the character  to  be  sent  to the
  8833.                          host. The "KBD LOCKED" message is cleared from the
  8834.                          Status Line.
  8835.  
  8836.           ESC [ 4 l      Insert-replacement - Selects replacement mode. Any
  8837.                          characters  received  overwrite  any characters on
  8838.  
  8839.  
  8840.  
  8841.                                                                    Page 129
  8842.  
  8843.  
  8844.  
  8845.  
  8846.  
  8847.  
  8848.           Appendix B                                            PC-VT v10.0
  8849.  
  8850.  
  8851.                          the screen at the  cursor  location.  This  is the
  8852.                          default setting.
  8853.  
  8854.           ESC [ 12 l     Send-Receive  Mode  -  Sets local echo. Characters
  8855.                          typed at the keyboard are locally displayed.
  8856.  
  8857.           ESC [ 20 l     Linefeed / New Line  -  Resets  PC-VT  to transmit
  8858.                          only   a carriage return when  the  ENTER  key  is
  8859.                          pressed.  Causes  received  linefeed, formfeed and
  8860.                          vertical tab characters to move cursor to the same
  8861.                          column of  the  next  line.  This  is  the default
  8862.                          setting.
  8863.  
  8864.           ESC [ ? 1 l    Cursor Key - Resets the  cursor  keys  to generate
  8865.                          ANSI (Cursor Mode)  control sequences. This is the
  8866.                          default  setting. For the VT102, this sequence  is
  8867.                          valid  only  in  Application  Keypad mode. For the
  8868.                          VT100, it is valid anytime.
  8869.  
  8870.           ESC [ ? 5 l    Screen - Resets the  screen  to  normal mode.  The
  8871.                          display attribute is changed  to  white  on black.
  8872.                          The entire display is flipped to  white  on black.
  8873.                          All   characters received after this sequence  are
  8874.                          displayed in white on black. This  is  the default
  8875.                          setting.
  8876.  
  8877.           ESC [ ? 6 l    Origin -  Resets the home position to the top left
  8878.                          of the screen. This is the default setting.
  8879.  
  8880.           ESC [ ? 7 l    Autowrap - Sets autowrap off. When the cursor gets
  8881.                          to the  right  margin  and  another  character  is
  8882.                          received,  the cursor remains at the right  margin
  8883.                          and   characters  overlay  one  another  until   a
  8884.                          carriage  return is  received.  This  the  default
  8885.                          setting.
  8886.  
  8887.           ESC [ ? 8 l    Autorepeat  - Sets autorepeat off. PC-VT can  only
  8888.                          simulate this function  since repeat is handled in
  8889.                          the keyboard by the 8048. When PC-VT receives this
  8890.                          escape sequence, it  clears the keyboard buffer of
  8891.                          any characters.
  8892.  
  8893.           ESC [ ? 18 l   Print Formfeed Off-  PC-VT performs a print screen
  8894.                          operation without a terminating formfeed.
  8895.  
  8896.           ESC [ ? 19 l   Print Extent - Only the  scrolling  region  of the
  8897.                          screen is printed on the selected  printer  by the
  8898.                          print screen sequence.
  8899.  
  8900.           ESC [ ? 24 l   Reset Buffer Load - The buffer  load  operation is
  8901.                          terminated. PC-VT private. See Appendix J.
  8902.  
  8903.           ESC [ ? 25 l   Send a formfeed to the printer. PC-VT private. See
  8904.                          Appendix J.
  8905.  
  8906.  
  8907.           Page 130
  8908.  
  8909.  
  8910.  
  8911.  
  8912.  
  8913.  
  8914.           PC-VT v10.0                                 VT100 & 4014 Emulator
  8915.  
  8916.  
  8917.           ESC [ ? 26 l   Start up HELP. Performs the  same  function  as if
  8918.                          the user had selected HELP from the  keyboard. PC-
  8919.                          VT private. See Appendix J.
  8920.  
  8921.           ESC [ ? 27 l   Start  up Command.COM. Performs the same  function
  8922.                          as if the user had select the DOS Gateway from the
  8923.                          keyboard. DOS is  entered in interactive mode. PC-
  8924.                          VT private. See Appendix J.
  8925.  
  8926.           ESC [ ? 28 l   Select EDT  editor  keypad  support.  Performs the
  8927.                          same function as  resetting  the  EVE  bit  in the
  8928.                          SETUP B frame. PC-VT private. See Appendix J.
  8929.  
  8930.           ESC [ ? 29 l   Select UNIX Operating System support. Performs the
  8931.                          same function as  resetting  the  VMS  bit  in the
  8932.                          SETUP B frame. PC-VT private. See Appendix J.
  8933.  
  8934.           Loading Macro Keys
  8935.  
  8936.                          This is a PC-VT extension which follows the format
  8937.                          of  the IBM ANSI.SYS keyboard redefinition.  PC-VT
  8938.                          can only redefine ALT-F1 thru ALT-F10.
  8939.  
  8940.           ESC [ 0 ; Pk ; "string" p
  8941.                          Sets macro key given  by  Pk  to the string inside
  8942.                          the double quotes. The double quotes and all other
  8943.                          characters shown are required. Pk must be  sent as
  8944.                          3  ASCII characters. Error Code is available  with
  8945.                          the "ESC [ ? 1 0 n" sequence.
  8946.  
  8947.                          Where Pk is:
  8948.  
  8949.                          104             ALT-F1
  8950.                          105             ALT-F2
  8951.                          106             ALT-F3
  8952.                          107             ALT-F4
  8953.                          108             ALT-F5
  8954.                          109             ALT-F6
  8955.                          110             ALT-F7
  8956.                          111             ALT-F8
  8957.                          112             ALT-F9
  8958.                          113             ALT-F10
  8959.  
  8960.  
  8961.  
  8962.  
  8963.  
  8964.  
  8965.  
  8966.  
  8967.  
  8968.  
  8969.  
  8970.  
  8971.  
  8972.  
  8973.                                                                    Page 131
  8974.  
  8975.  
  8976.  
  8977.  
  8978.  
  8979.  
  8980.           Appendix B                                            PC-VT v10.0
  8981.  
  8982.  
  8983.  
  8984.  
  8985.  
  8986.  
  8987.  
  8988.  
  8989.  
  8990.  
  8991.  
  8992.  
  8993.  
  8994.  
  8995.  
  8996.  
  8997.  
  8998.  
  8999.  
  9000.  
  9001.  
  9002.  
  9003.  
  9004.  
  9005.  
  9006.  
  9007.  
  9008.  
  9009.  
  9010.  
  9011.  
  9012.  
  9013.  
  9014.  
  9015.  
  9016.  
  9017.  
  9018.  
  9019.  
  9020.  
  9021.  
  9022.  
  9023.  
  9024.  
  9025.  
  9026.  
  9027.  
  9028.  
  9029.  
  9030.  
  9031.  
  9032.  
  9033.  
  9034.  
  9035.  
  9036.  
  9037.  
  9038.  
  9039.           Page 132
  9040.  
  9041.  
  9042.  
  9043.  
  9044.  
  9045.  
  9046.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9047.  
  9048.  
  9049.  
  9050.  
  9051.  
  9052.  
  9053.  
  9054.  
  9055.                                      Appendix C
  9056.  
  9057.                          VT100 Transmitted Escape Sequences
  9058.  
  9059.  
  9060.                   Control keys which do not have a defined  ASCII  code are
  9061.           translated into escape sequences for  transmission  to  the host.
  9062.           These keys are the cursor keys and the keypad keys. Both  sets of
  9063.           these keys can transmit  different  sequences.  The codes sent by
  9064.           the keypad keys are selected by the "Set Numeric Keypad" and "Set
  9065.           Application keypad" commands.  The  codes for the cursor keys are
  9066.           selected by the "Set  Cursor"  and  "Reset Cursor" mode commands.
  9067.           Note that setting numeric keypad mode resets the cursor mode. Set
  9068.           and reset cursor  mode  only function in application keypad mode.
  9069.           This VT100 defined numeric keypad mode has nothing to do with the
  9070.           PC NUM LOCK key. The NUM LOCK key  functions  locally  in  the PC
  9071.           only per the IBM documentation.
  9072.  
  9073.  
  9074.           VT100 Cursor Keys
  9075.  
  9076.           Key     Reset (Cursor) Mode
  9077.                                           Set (Application) mode
  9078.  
  9079.           Up      ESC [ A                 ESC O A Down
  9080.                   ESC [ B                 ESC O B Right
  9081.                   ESC [ C                 ESC O C Left
  9082.                   ESC [ D                 ESC O D
  9083.  
  9084.  
  9085.  
  9086.  
  9087.  
  9088.  
  9089.  
  9090.  
  9091.  
  9092.  
  9093.  
  9094.  
  9095.  
  9096.  
  9097.  
  9098.  
  9099.  
  9100.  
  9101.  
  9102.  
  9103.  
  9104.  
  9105.                                                                    Page 133
  9106.  
  9107.  
  9108.  
  9109.  
  9110.  
  9111.  
  9112.           Appendix C                                            PC-VT v10.0
  9113.  
  9114.  
  9115.           VT100 Emulated Keypad Keys
  9116.  
  9117.           IBM PC          Emulated        ANSI Numeric    ANSI    Alternate
  9118.           Key VT100 Key Keypad Mode
  9119.                                                           Keypad Mode
  9120.  
  9121.           F10             0               0               ESC O p F7
  9122.                           1               1               ESC O q F8
  9123.                           2               2               ESC O r SHIFT-F7
  9124.                           3               3               ESC O s F5
  9125.                           4               4               ESC O t F6
  9126.                           5               5               ESC O u SHIFT-F5
  9127.                           6               6               ESC O v F3
  9128.                           7               7               ESC O w F4
  9129.                           8               8               ESC O x SHIFT-F3
  9130.                           9               9               ESC O y SHIFT-F4
  9131.                           -(minus)        -(minus)        ESC O m SHIFT-F6
  9132.                           ,(comma)        ,(comma)        ESC O l SHIFT-F9
  9133.                           .(period)       .(period)       ESC O n SHIFT-F8
  9134.                           Enter           Enter           ESC O M F1
  9135.                           PF1             ESC O P         ESC O P F2
  9136.                           PF2             ESC O Q         ESC O Q SHIFT-F1
  9137.                           PF3             ESC O R         ESC O R SHIFT-F2
  9138.                           PF4             ESC O S         ESC O S
  9139.  
  9140.  
  9141.           VT52 Cursor Keys
  9142.  
  9143.           Key     Reset (Cursor) Mode     Set (Application) mode
  9144.  
  9145.           Up      ESC A                   ESC A Down
  9146.                   ESC B                   ESC B Right
  9147.                   ESC C                   ESC C Left
  9148.                   ESC D                   ESC D
  9149.  
  9150.  
  9151.  
  9152.  
  9153.  
  9154.  
  9155.  
  9156.  
  9157.  
  9158.  
  9159.  
  9160.  
  9161.  
  9162.  
  9163.  
  9164.  
  9165.  
  9166.  
  9167.  
  9168.  
  9169.  
  9170.  
  9171.           Page 134
  9172.  
  9173.  
  9174.  
  9175.  
  9176.  
  9177.  
  9178.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9179.  
  9180.  
  9181.           VT52 Emulated Keypad Keys
  9182.  
  9183.           IBM PC          Emulated        ANSI Numeric    ANSI    Alternate
  9184.           Key VT100 Key Keypad Mode Keypad Mode
  9185.  
  9186.           F10             0               0               ESC ? p F7
  9187.                           1               1               ESC ? q F8
  9188.                           2               2               ESC ? r SHIFT-F7
  9189.                           3               3               ESC ? s F5
  9190.                           4               4               ESC ? t F6
  9191.                           5               5               ESC ? u SHIFT-F5
  9192.                           6               6               ESC ? v F3
  9193.                           7               7               ESC ? w F4
  9194.                           8               8               ESC ? x SHIFT-F3
  9195.                           9               9               ESC ? y SHIFT-F4
  9196.                           -(minus)        -(minus)        ESC ? m SHIFT-F6
  9197.                           ,(comma)        ,(comma)        ESC ? l SHIFT-F9
  9198.                           .(period)       .(period)       ESC ? n SHIFT-F8
  9199.                           Enter           Enter           ESC ? M F1
  9200.                           PF1             ESC P           ESC ? P F2
  9201.                           PF2             ESC Q           ESC ? Q SHIFT-F1
  9202.                           PF3             ESC R           ESC ? R SHIFT-F2
  9203.                           PF4             ESC S           ESC ? S
  9204.  
  9205.  
  9206.  
  9207.  
  9208.  
  9209.  
  9210.  
  9211.  
  9212.  
  9213.  
  9214.  
  9215.  
  9216.  
  9217.  
  9218.  
  9219.  
  9220.  
  9221.  
  9222.  
  9223.  
  9224.  
  9225.  
  9226.  
  9227.  
  9228.  
  9229.  
  9230.  
  9231.  
  9232.  
  9233.  
  9234.  
  9235.  
  9236.  
  9237.                                                                    Page 135
  9238.  
  9239.  
  9240.  
  9241.  
  9242.  
  9243.  
  9244.           Appendix C                                            PC-VT v10.0
  9245.  
  9246.  
  9247.  
  9248.  
  9249.  
  9250.  
  9251.  
  9252.  
  9253.  
  9254.  
  9255.  
  9256.  
  9257.  
  9258.  
  9259.  
  9260.  
  9261.  
  9262.  
  9263.  
  9264.  
  9265.  
  9266.  
  9267.  
  9268.  
  9269.  
  9270.  
  9271.  
  9272.  
  9273.  
  9274.  
  9275.  
  9276.  
  9277.  
  9278.  
  9279.  
  9280.  
  9281.  
  9282.  
  9283.  
  9284.  
  9285.  
  9286.  
  9287.  
  9288.  
  9289.  
  9290.  
  9291.  
  9292.  
  9293.  
  9294.  
  9295.  
  9296.  
  9297.  
  9298.  
  9299.  
  9300.  
  9301.  
  9302.  
  9303.           Page 136
  9304.  
  9305.  
  9306.  
  9307.  
  9308.  
  9309.  
  9310.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9311.  
  9312.  
  9313.  
  9314.  
  9315.  
  9316.  
  9317.  
  9318.  
  9319.                                      Appendix D
  9320.  
  9321.                          VT100 Responses to Escape Sequences
  9322.  
  9323.  
  9324.                   PC-VT  responds to several control characters and  escape
  9325.           sequences. They are listed  here.  For  a complete description of
  9326.           all escape sequences see Appendix B.
  9327.  
  9328.           Elicitor                Response
  9329.  
  9330.           Enquire                 Answerback message.
  9331.  
  9332.           Device Status Report    PC-VT responds with emulator status.
  9333.  
  9334.           Cursor Status Report    Current cursor position is reported.
  9335.  
  9336.           Device Attributes       PC-VT identifies itself as either a or
  9337.                                   VT100,  a  VT102,  or  a  VT52  depending
  9338.           Identify Terminal on the bits set/reset in the SETUP B  or frame.
  9339.           What Are You
  9340.  
  9341.           Request Terminal        PC-VT responds with information regarding
  9342.           Parameters communications parameters
  9343.  
  9344.  
  9345.  
  9346.  
  9347.  
  9348.  
  9349.  
  9350.  
  9351.  
  9352.  
  9353.  
  9354.  
  9355.  
  9356.  
  9357.  
  9358.  
  9359.  
  9360.  
  9361.  
  9362.  
  9363.  
  9364.  
  9365.  
  9366.  
  9367.  
  9368.  
  9369.                                                                    Page 137
  9370.  
  9371.  
  9372.  
  9373.  
  9374.  
  9375.  
  9376.           Appendix D                                            PC-VT v10.0
  9377.  
  9378.  
  9379.  
  9380.  
  9381.  
  9382.  
  9383.  
  9384.  
  9385.  
  9386.  
  9387.  
  9388.  
  9389.  
  9390.  
  9391.  
  9392.  
  9393.  
  9394.  
  9395.  
  9396.  
  9397.  
  9398.  
  9399.  
  9400.  
  9401.  
  9402.  
  9403.  
  9404.  
  9405.  
  9406.  
  9407.  
  9408.  
  9409.  
  9410.  
  9411.  
  9412.  
  9413.  
  9414.  
  9415.  
  9416.  
  9417.  
  9418.  
  9419.  
  9420.  
  9421.  
  9422.  
  9423.  
  9424.  
  9425.  
  9426.  
  9427.  
  9428.  
  9429.  
  9430.  
  9431.  
  9432.  
  9433.  
  9434.  
  9435.           Page 138
  9436.  
  9437.  
  9438.  
  9439.  
  9440.  
  9441.  
  9442.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9443.  
  9444.  
  9445.  
  9446.  
  9447.  
  9448.  
  9449.  
  9450.  
  9451.                                      Appendix E
  9452.  
  9453.                           VT100 Special ALT Key Definitions
  9454.  
  9455.  
  9456.                   PC-VT uses ALT-F to startup  the  DOS  Command Processor,
  9457.           ALT-Z to send a hangup command  to  the modem, ALT-H to start the
  9458.           HELP  facility,  and  ALT-X  to  clear  a  received XOFF  control
  9459.           character. You can tell if an XOFF has been received  because PC-
  9460.           VT displays an X on the status line.
  9461.  
  9462.                   Additionally,  several  special  ALT  key   commands  are
  9463.           available to the user  of  PC-VT. They were implemented to aid in
  9464.           the debug of this program. Most of these are  useful  only  under
  9465.           very special circumstances but some may be of general use. To use
  9466.           these  commands,  hold down the ALT key  and  at  the  same  time
  9467.           depress  the key listed. They work  only  in  the  communications
  9468.           frame and not in the SETUP, DIALING, or MACRO frames.  Other than
  9469.           the above mentioned keys, no  claims or guarantees are make about
  9470.           these keys and you use them at your own risk.
  9471.  
  9472.           ALT Key plus    Function
  9473.  
  9474.  
  9475.           C              Performs  the  same  function  as the CTRL-F8 key.
  9476.                          Terminates PC-VT. Mostly for PCjr users.
  9477.  
  9478.           E              Toggles Echo. This key toggles  the  state  of the
  9479.                          echo  flag.  If  the  host  is  not  echoing  back
  9480.                          characters,  you can press ALT-E and PC-VT  echoes
  9481.                          the characters to the display.
  9482.  
  9483.           F              Fork. This key sequence starts up another  copy of
  9484.                          Command.COM without terminating PC-VT or  breaking
  9485.                          the host connection.  Once the new  Command.COM is
  9486.                          started, you  can run any DOS function or other PC
  9487.                          program.  You should be careful that you don't run
  9488.                          a  program that uses the same communications  port
  9489.                          as PC-VT is using.    The  other program may leave
  9490.                          the port in an  unexpected  state.   PC-VT may not
  9491.                          then be able to get  control  of  the  port again.
  9492.                          Also be careful that  you  don't  alter  any files
  9493.                          which PC-VT may be using.  To  exit  from  the new
  9494.                          copy  of  Command.COM and return  to  PC-VT,  type
  9495.                          "exit" at the command prompt.
  9496.  
  9497.           G              Prints  current  line.  The  line  containing  the
  9498.                          cursor  is  printed on the  selected  printer,  if
  9499.  
  9500.  
  9501.                                                                    Page 139
  9502.  
  9503.  
  9504.  
  9505.  
  9506.  
  9507.  
  9508.           Appendix E                                            PC-VT v10.0
  9509.  
  9510.  
  9511.                          present. Performs the  same function as receipt of
  9512.                          a "ESC [ ? 1 i" sequence.
  9513.  
  9514.           H              HELP. Starts up the HELP  frame.  Check  the index
  9515.                          for more information on the ALT-H key and HELP.
  9516.  
  9517.           K              Starts up the KERMIT file transfer module.
  9518.  
  9519.           M              Toggles  "Ignore Nulls"  mode.  NUL(ASCII  0)  and
  9520.                          DEL(ASCII 127)  characters  are  not  normally put
  9521.                          into the  communications  buffer.  This  switch on
  9522.                          causes those characters to be  put  in  the buffer
  9523.                          just as all other characters. These characters are
  9524.                          eventually ignored  by  PC-VT,  the  difference is
  9525.                          that they  now take up I/O buffer space and cannot
  9526.                          be used as "filler" or timing characters.
  9527.  
  9528.           N              Toggles  "Ignore  ESCAPE"  mode.  Received  escape
  9529.                          sequences  are not acted upon. They are  displayed
  9530.                          as regular characters on  the  screen.  The escape
  9531.                          character itself is displayed as "<ESC>". Toggling
  9532.                          this  switch  at  the  wrong  time  may   lead  to
  9533.                          unpredictable    results.    Autowrap    is    set
  9534.                          automatically when this switch is set.
  9535.  
  9536.           O              Performs the same function  as  the  CTRL-F10 key.
  9537.                          Calls up the MACRO frame. Mostly for PCjr users.
  9538.  
  9539.           P              Sends a formfeed to  the  printer  if a printer is
  9540.                          attached.
  9541.  
  9542.           R              Restarts PC-VT. Clears COMx port and restarts from
  9543.                          the beginning. Selected features and tab stops are
  9544.                          not  changed. Host connection is not broken.  This
  9545.                          command is useful if you make the  host connection
  9546.                          after PC-VT is  started  and COMx port needs to be
  9547.                          initialized.   In   most  cases,   though,   PC-VT
  9548.                          initializes the port without the need for this.
  9549.  
  9550.           S              Initiates  the Scroll Buffer. When you press  this
  9551.                          key, PC-VT tries to allocate an additional  32K of
  9552.                          memory in which it keeps  the  last  5  screens of
  9553.                          information.   The  Scroll  Buffer  can  also   be
  9554.                          initiated by a feature selection  in  the  SETUP B
  9555.                          frame.
  9556.  
  9557.           V              Performs  the  same  function  as the CTRL-F9 key.
  9558.                          Calls up the DIALING frame. Mostly for PCjr users.
  9559.  
  9560.           X              Resets XOFF Flag. If PC-VT  has  received  an XOFF
  9561.                          character,  it does not transmit anything. If  you
  9562.                          type a character, PC-VT beeps and ignores  the key
  9563.                          you pressed. This is part of the VT100 definition.
  9564.                          If something happens and  PC-VT  receives  an XOFF
  9565.  
  9566.  
  9567.           Page 140
  9568.  
  9569.  
  9570.  
  9571.  
  9572.  
  9573.  
  9574.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9575.  
  9576.  
  9577.                          because of garbage on the communications line, you
  9578.                          can reset the XOFF flag by pressing ALT-X.
  9579.  
  9580.           Z              Hangs  up  the  phone.  PC-VT  performs  the  same
  9581.                          functions as if you had entered the  DIALING frame
  9582.                          and pressed F5. That is, the Hayes compatible hang
  9583.                          up command is sent to the modem.
  9584.  
  9585.  
  9586.  
  9587.  
  9588.  
  9589.  
  9590.  
  9591.  
  9592.  
  9593.  
  9594.  
  9595.  
  9596.  
  9597.  
  9598.  
  9599.  
  9600.  
  9601.  
  9602.  
  9603.  
  9604.  
  9605.  
  9606.  
  9607.  
  9608.  
  9609.  
  9610.  
  9611.  
  9612.  
  9613.  
  9614.  
  9615.  
  9616.  
  9617.  
  9618.  
  9619.  
  9620.  
  9621.  
  9622.  
  9623.  
  9624.  
  9625.  
  9626.  
  9627.  
  9628.  
  9629.  
  9630.  
  9631.  
  9632.  
  9633.                                                                    Page 141
  9634.  
  9635.  
  9636.  
  9637.  
  9638.  
  9639.  
  9640.           Appendix E                                            PC-VT v10.0
  9641.  
  9642.  
  9643.                   The following ALT keys work only in Numeric Keypad mode (
  9644.           the  default mode).
  9645.  
  9646.           ALT Key plus    Function
  9647.  
  9648.  
  9649.           A              Turns on Print Only Mode. All characters sent from
  9650.                          the host are printed on the selected printer only.
  9651.                          Performs the  same function as receipt of a "ESC [
  9652.                          5 i" sequence.
  9653.  
  9654.           B              Transmits  the  answerback message.  Performs  the
  9655.                          same  function  as receipt of  a  Enquire  Control
  9656.                          Character (ASCII 5). Performs the same function as
  9657.                          the VT HERE IS key
  9658.  
  9659.           D              Turns off  Print  Only  Mode.  Performs  the  same
  9660.                          function as receipt of a "ESC [ 4 i" sequence.
  9661.  
  9662.           W              Reports   Terminal   Status.   Performs  the  same
  9663.                          function as receipt of a "ESC [ 5 n" sequence.
  9664.  
  9665.           Y              Reports Printer Status. Performs the same function
  9666.                          as receipt of a "ESC [ ? 15 n" sequence.
  9667.  
  9668.           U              Reports  Device  Attributes.  Performs  the   same
  9669.                          function as receipt of a "ESC [ c" sequence.
  9670.  
  9671.           H              Clears  Tab  Stop.  Performs  the same function as
  9672.                          receipt of a "ESC [  0 g" sequence. You should use
  9673.                          the SETUP A frame.
  9674.  
  9675.           J              Sets Tab  Stop.  Performs  the  same  function  as
  9676.                          receipt of  a "ESC H" sequence. You should use the
  9677.                          SETUP A frame.
  9678.  
  9679.           L              Clears  All Tab Stops. Performs the same  function
  9680.                          as receipt of a "ESC [ 3 g"  sequence.  You should
  9681.                          use the SETUP A frame.
  9682.  
  9683.  
  9684.  
  9685.  
  9686.  
  9687.  
  9688.  
  9689.  
  9690.  
  9691.  
  9692.  
  9693.  
  9694.  
  9695.  
  9696.  
  9697.  
  9698.  
  9699.           Page 142
  9700.  
  9701.  
  9702.  
  9703.  
  9704.  
  9705.  
  9706.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9707.  
  9708.  
  9709.  
  9710.  
  9711.  
  9712.  
  9713.  
  9714.  
  9715.                                      Appendix F
  9716.  
  9717.                          4014 Received Character Processing
  9718.  
  9719.  
  9720.                   The next appendices describe  the  internal  operation of
  9721.           PC-VT in 4014 mode. They show the various  characters  and escape
  9722.           sequences which PC-VT interprets as commands. The character "ESC"
  9723.           is an ASCII control character with the decimal value of 27.
  9724.  
  9725.                   The  emulator  runs  in  4  basic modes -  Alpha,  Graph,
  9726.           Bypass/GIN  and  LCE.   The  control  characters  have  different
  9727.           meanings in each of those modes.
  9728.  
  9729.  
  9730.           F.1  Alpha Mode
  9731.  
  9732.  
  9733.                   Alpha mode is the default mode for the  emulator.  If you
  9734.           are using the IBM  Color  Graphics  Adapter, ASCII characters are
  9735.           displayed as either 25 lines of 80 characters or 33 lines  of 106
  9736.           characters.  If you are using the Everex  Edge  or  the  Hercules
  9737.           card,  characters   are  displayed  as  either  43  lines  of  90
  9738.           characters or  58 lines of 120 characters. Control characters are
  9739.           acted upon per the 4014 definition.
  9740.  
  9741.                   Use the following commands to enter Alpha mode:
  9742.  
  9743.           ESC FF         To clear the screen  and  move  the cursor to home
  9744.                          position.
  9745.  
  9746.           CR             To move the cursor to the left margin  in  the row
  9747.                          which contains the current graphic beam position.
  9748.  
  9749.           US             To enter Alpha mode  with  cursor  at  the current
  9750.                          Graphics beam position.
  9751.  
  9752.                   ASCII codes from 0  to  31  are control characters. PC-VT
  9753.           responds to these characters as listed in the following table.
  9754.  
  9755.           Name            Code    Function
  9756.  
  9757.             NUL           0       Ignored.
  9758.             SOH           1       Ignored.
  9759.             STX           2       Ignored.
  9760.             ETX           3       Ignored.
  9761.             EOT           4       Ignored.
  9762.             ENQ           5       Ignored.
  9763.  
  9764.  
  9765.                                                                    Page 143
  9766.  
  9767.  
  9768.  
  9769.  
  9770.  
  9771.  
  9772.           Appendix F                                            PC-VT v10.0
  9773.  
  9774.  
  9775.             ACK           6       Ignored.
  9776.             BEL           7       Causes PC-VT to beep the IBM PC speaker.
  9777.             BS            8       Causes PC-VT to move the cursor one space
  9778.                                   right. If the cursor is already in the
  9779.                                   rightmost  column,   this   character  is
  9780.           ignored.
  9781.                                   Characters backspaced over are NOT erased
  9782.                                   from the screen.
  9783.             HT            9       Causes PC-VT to move the cursor one space
  9784.                                   left. If the cursor is already in the
  9785.                                   leftmost column, HT causes an automatic
  9786.                                   linefeed and carriage return.
  9787.             LF            10      This causes the cursor to move down one
  9788.                                   line in the current column. If the
  9789.                                   cursor moves below the screen output
  9790.                                   area, the lines above the cursor move up
  9791.                                   one line, and a blank line is added to
  9792.                                   the bottom of the screen. The operation
  9793.                                   of this key is modified by the LF Effect
  9794.                                   feature selected in SETUP B.
  9795.             VT            11      This causes the cursor to move up one
  9796.                                   line in the current column. If the cursor
  9797.                                   is in the top line, VT wraps to the
  9798.                                   bottom line.
  9799.             FF            12      Ignored.
  9800.             CR            13      The cursor is moved back to the left
  9801.                                   margin. Cursor remains in the current
  9802.                                   line.
  9803.             SO            14      Ignored.
  9804.             SI            15      Ignored.
  9805.             DLE           16      Ignored.
  9806.             XON           16      Restart transmission, if stopped.
  9807.             DC2           18      Ignored.
  9808.             XOFF          19      Stop transmission until XON is Received.
  9809.             DC4           20      Ignored.
  9810.             NAK           21      Ignored.
  9811.             SYN           22      Ignored.
  9812.             ETB           23      Ignored.
  9813.             CAN           24      Ignored.
  9814.             EM            25      Ignored.
  9815.             SUB           26      Ignored.
  9816.             ESC           27      Sets LCE mode.
  9817.             FS            28      Sets Point Plot mode.
  9818.             GS            29      Sets Graph mode to do a dark (invisible)
  9819.                                   vector.
  9820.             RS            30      Sets Incremental Plot mode.
  9821.             US            31      Ignored.
  9822.  
  9823.  
  9824.                   ASCII  codes  from  32("  ")  to  126("~")  are taken  as
  9825.           displayable characters.
  9826.  
  9827.                   ASCII code 127(DEL) is ignored.
  9828.  
  9829.  
  9830.  
  9831.           Page 144
  9832.  
  9833.  
  9834.  
  9835.  
  9836.  
  9837.  
  9838.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9839.  
  9840.  
  9841.                   To move the cursor to any desired position:
  9842.  
  9843.             1.  enter Graph mode with the GS command,
  9844.  
  9845.             2.  specify the graphics coordinates, and then
  9846.  
  9847.             3.  return to Alpha mode using the US command.
  9848.  
  9849.           For example,  to display the word PC-VT at coordinates (680,585),
  9850.           send:
  9851.  
  9852.           <GS>2i5H<US>PC-VT
  9853.  
  9854.  
  9855.           F.2  Graph Mode
  9856.  
  9857.  
  9858.                   Graph  mode  is  used to draw  vectors.  A  vector  is  a
  9859.           sequence  of  dots  on the screen. You enter Graph mode with a GS
  9860.           control character from Alpha mode. The first  coordinate received
  9861.           in  Graph  mode  does not cause any output to the screen. This is
  9862.           called a dark vector. It is  used  to MOVE to the beginning point
  9863.           of the  first vector to be drawn. Subsequent coordinates received
  9864.           DRAW a vector from the previous coordinate to the new coordinate.
  9865.           Vector drawing modes are set from LCE mode.
  9866.  
  9867.                   Use the following command to enter Graph mode:
  9868.  
  9869.           GS             Enter Graph mode with  the  beam  position  at the
  9870.                          lower  left  corner of the  current  Alpha  cursor
  9871.                          position.
  9872.  
  9873.                   Characters received are interpreted as coordinates. Up to
  9874.           5  characters  are  needed  to  form  a  single  coordinate.  The
  9875.           characters received must be in the following format and sequence:
  9876.  
  9877.  
  9878.                                   7 bit Character
  9879.           Byte    -------------------------------------------------
  9880.           Name    6       5       4       3       2       1       0
  9881.           ----    -------------------------------------------------
  9882.           HIY     0       1       ----- 5 MSB of Y Coordinate -----
  9883.  
  9884.           Extra   1       1       X       Y2      Y1      X2      X1
  9885.  
  9886.           LOY     1       1       ----- 5 LSB of Y Coordinate -----
  9887.  
  9888.           HIX     0       1       ----- 5 MSB of X Coordinate -----
  9889.  
  9890.           LOX     1       0       ----- 5 LSB of X Coordinate -----
  9891.  
  9892.             X = not used.
  9893.  
  9894.  
  9895.  
  9896.  
  9897.                                                                    Page 145
  9898.  
  9899.  
  9900.  
  9901.  
  9902.  
  9903.  
  9904.           Appendix F                                            PC-VT v10.0
  9905.  
  9906.  
  9907.                   The  extra byte is only used when  forming  12  bit  4014
  9908.           coordinates. In that case, the Y2  and  Y1 bits become the LSB of
  9909.           the  Y  coordinate  and  X2  and  X1  become the  LSB  of  the  X
  9910.           coordinate.
  9911.  
  9912.                   Note: MSB means Most Significant or Leftmost bits and LSB
  9913.           means Least Significant or Rightmost bits.
  9914.  
  9915.  
  9916.                   All  five  bytes do not need to  be  sent  for  each  new
  9917.           coordinate. PC-VT  remembers certain bytes. If those bytes do not
  9918.           change, they  do not have to be transmitted. Coordinate addresses
  9919.           may be shortened as follows:
  9920.  
  9921.  
  9922.           Bytes which             Bytes which must be sent
  9923.              change       HIY     Extra   LOY     HIX     LOX
  9924.  
  9925.              Hi Y         #                               #
  9926.              Extra                #       #               #
  9927.              Lo Y                         #               #
  9928.              Hi X                         #       #       #
  9929.              Lo X                                         #
  9930.  
  9931.                   The LOX byte must always be transmitted. As soon as PC-VT
  9932.           receives the LOX byte, it plots the point.
  9933.  
  9934.                   Here is an example of a typical move and draw sequence:
  9935.  
  9936.  
  9937.  
  9938.           ASCII           Binary                  Command
  9939.             GS (1Dh)      X  0  0  1  1  1  0  1  enter Graph mode
  9940.  
  9941.           First set of coordinates : move to (0,0)
  9942.             Space (20h)   X  0  1  0  0  0  0  0  HIY = 00000
  9943.             `  (60h)      X  1  1  0  0  0  0  0  LOY = 00000
  9944.             Space (20h)   X  0  1  0  0  0  0  0  HIX = 00000
  9945.             @  (40h)      X  1  0  0  0  0  0  0  LOX = 00000
  9946.  
  9947.           Second set of coordinates : draw to (512,512)
  9948.             0  (30h)      X  0  1  1  0  0  0  0  HIY = 10000
  9949.             `  (60h)      X  1  1  0  0  0  0  0  LOY = 00000
  9950.             0  (30h)      X  0  1  1  0  0  0  0  HIX = 10000
  9951.             @  (40h)      X  1  0  0  0  0  0  0  LOX = 00000
  9952.  
  9953.             US (1Fh)      X  0  0  1  1  1  1  1  enter Alpha mode
  9954.  
  9955.             X = parity bit - don't care)
  9956.  
  9957.                   ASCII codes from 0  to  31  are control characters. PC-VT
  9958.           responds to these characters as listed in the following table.
  9959.  
  9960.           Name            Code    Function
  9961.  
  9962.  
  9963.           Page 146
  9964.  
  9965.  
  9966.  
  9967.  
  9968.  
  9969.  
  9970.           PC-VT v10.0                                 VT100 & 4014 Emulator
  9971.  
  9972.  
  9973.             NUL           0       Ignored.
  9974.             SOH           1       Ignored.
  9975.             STX           2       Ignored.
  9976.             ETX           3       Ignored.
  9977.             EOT           4       Ignored.
  9978.             ENQ           5       Ignored.
  9979.             ACK           6       Ignored.
  9980.             BEL           7       Causes PC-VT to beep the IBM PC speaker.
  9981.             BS            8       Ignored.
  9982.             HT            9       Ignored.
  9983.             LF            10      Ignored.
  9984.             VT            11      Ignored.
  9985.             FF            12      Ignored.
  9986.             CR            13      Set Alpha mode.The cursor is moved
  9987.                                   back to the left margin.
  9988.             SO            14      Ignored.
  9989.             SI            15      Ignored.
  9990.             DLE           16      Ignored.
  9991.             XON           16      Restart transmission, if stopped.
  9992.             DC2           18      Ignored.
  9993.             XOFF          19      Stop transmission until XON is received.
  9994.             DC4           20      Ignored.
  9995.             NAK           21      Ignored.
  9996.             SYN           22      Ignored.
  9997.             ETB           23      Ignored.
  9998.             CAN           24      Ignored.
  9999.             EM            25      Ignored.
  10000.             SUB           26      Ignored.
  10001.             ESC           27      Sets LCE mode.
  10002.             FS            28      Sets Point Plot mode.
  10003.             GS            29      Do a dark (invisible) vector.
  10004.             RS            30      Sets Incremental Plot mode.
  10005.             US            31      Set Alpha mode.
  10006.  
  10007.  
  10008.                   ASCII codes 32(" ") thru 63("?") are taken as either HIGH
  10009.           X or HIGH Y graph coordinates.
  10010.  
  10011.                   ASCII codes 64("@") thru 95("_") are taken as LOW X graph
  10012.           coordinates.
  10013.  
  10014.                   ASCII codes  96("`") thru 126("~") are taken as LOY graph
  10015.           coordinates.
  10016.  
  10017.                   ASCII  code  127(DEL)  is  taken  as either a  LOY  graph
  10018.           coordinate or is ignored depending  on the setting the LOY option
  10019.           in the SETUP B frame.
  10020.  
  10021.  
  10022.  
  10023.  
  10024.  
  10025.  
  10026.  
  10027.  
  10028.  
  10029.                                                                    Page 147
  10030.  
  10031.  
  10032.  
  10033.  
  10034.  
  10035.  
  10036.           Appendix F                                            PC-VT v10.0
  10037.  
  10038.  
  10039.                                    Point Plot Mode
  10040.  
  10041.  
  10042.                   Point  plot   mode  is  a  submode  of  Graph  mode.  All
  10043.           characters are interpreted  exactly  the same as Graph mode. This
  10044.           only difference, is that instead  of drawing a vector, PC-VT only
  10045.           displays the end points.
  10046.  
  10047.                   Use the following command to enter Point Plot mode:
  10048.  
  10049.            FS            Enter Point Plot mode with  the  beam  position at
  10050.                          the lower left corner of the current  Alpha cursor
  10051.                          position.
  10052.  
  10053.  
  10054.  
  10055.  
  10056.                                 Incremental Plot Mode
  10057.  
  10058.  
  10059.                   Incremental plot mode is a  submode  of  Graph  mode. The
  10060.           control characters 0 to 31 are handled as in Graph mode.  In this
  10061.           mode, the  drawing  beam  can  be  directly  controlled. Received
  10062.           characters shown below cause  the  beam  to  move in one Tekpoint
  10063.           increments. Since each dot on the PC's screen  may  cover several
  10064.           Tekpoints, it may take several movement commands to actually show
  10065.           a movement on the screen.
  10066.  
  10067.                   Use the following command to enter Incremental Plot mode:
  10068.  
  10069.           RS             Enter Incremental Plot mode with the beam position
  10070.                          at the lower  left  corner  of  the  current Alpha
  10071.                          cursor position.
  10072.  
  10073.                   Other characters are interpreted as follows:
  10074.  
  10075.  
  10076.  
  10077.           Character               Function
  10078.           space           Turns beam off
  10079.           A               Move beam one Tekpoint east
  10080.           B               Move beam one Tekpoint west
  10081.           D               Move beam one Tekpoint north
  10082.           E               Move beam one Tekpoint northeast
  10083.           F               Move beam one Tekpoint northwest
  10084.           H               Move beam one Tekpoint south
  10085.           I               Move beam one Tekpoint southeast
  10086.           J               Move beam one Tekpoint southwest
  10087.           P               Turns beam on
  10088.  
  10089.  
  10090.  
  10091.  
  10092.  
  10093.  
  10094.  
  10095.           Page 148
  10096.  
  10097.  
  10098.  
  10099.  
  10100.  
  10101.  
  10102.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10103.  
  10104.  
  10105.                                Special Point Plot Mode
  10106.  
  10107.  
  10108.                   Special Point Plot mode functions  just  like  Point Plot
  10109.           mode except that the first character in the  point  coordinate is
  10110.           an intensity level. PC-VT supports only 0 and 100% intensity. The
  10111.           "@"  character indicates zero intensity (or  beam  off)  and  all
  10112.           other valid 4014 intensity codes produce 100% intensity.
  10113.  
  10114.                   Use the following command  to  enter  Special  Point Plot
  10115.           mode:
  10116.  
  10117.           ESC FS         Enter  Special  Point  Plot  mode  with  the  beam
  10118.                          position at the lower left corner  of  the current
  10119.                          Alpha cursor position.
  10120.  
  10121.                   The beam intensity set by this command  remains unchanged
  10122.           if you switch to Point Plot or Incremental Point Plot modes or if
  10123.           you switch back into Special Point Plot mode.
  10124.  
  10125.  
  10126.  
  10127.  
  10128.                                  Exiting Graph mode
  10129.  
  10130.  
  10131.                   There are several ways to exit Graph mode and enter Alpha
  10132.           mode. The character which you use determines the action taken:
  10133.  
  10134.           ESC FF         Erases the screen and moves the cursor to the home
  10135.                          position.
  10136.  
  10137.           CR             Moves the cursor to the left margin in the current
  10138.                          line.
  10139.  
  10140.           US             Leaves the cursor at its current position.
  10141.  
  10142.           ESC SUB        Switches to GIN mode  and  displays  the crosshair
  10143.                          cursor.
  10144.  
  10145.           FS             Switches to Point Plot mode.
  10146.  
  10147.  
  10148.           F.3  Bypass/GIN Mode
  10149.  
  10150.  
  10151.                   Use the following command to enter Bypass/GIN mode:
  10152.  
  10153.           ESC SUB        Enter Bypass/GIN mode with the crosshair displayed
  10154.                          at the last graph coordinate.
  10155.  
  10156.                   In  Bypass/GIN  mode,  the  host has requested coordinate
  10157.           information from PC-VT. PC-VT displays a  crosshair  pointer. You
  10158.           can  move  the  pointer  with  the  keypad  arrow keys.  You  can
  10159.  
  10160.  
  10161.                                                                    Page 149
  10162.  
  10163.  
  10164.  
  10165.  
  10166.  
  10167.  
  10168.           Appendix F                                            PC-VT v10.0
  10169.  
  10170.  
  10171.           terminate  GIN mode by pressing any ASCII key  or  the  host  can
  10172.           terminate it by sending ESC  ENQ. In both cases, PC-VT  sends the
  10173.           current  pointer  position  to  the  host.  The  format  of  this
  10174.           transmission is described in Appendix G.
  10175.  
  10176.                   ASCII codes from 0  to  31  are control characters. PC-VT
  10177.           responds to these characters as listed in the following table.
  10178.  
  10179.           Name    Code    Function
  10180.  
  10181.             NUL           0       Ignored.
  10182.             SOH           1       Ignored.
  10183.             STX           2       Ignored.
  10184.             ETX           3       Ignored.
  10185.             EOT           4       Ignored.
  10186.             ENQ           5       Ignored.
  10187.             ACK           6       Ignored.
  10188.             BEL           7       Causes PC-VT to beep the IBM PC speaker.
  10189.             BS            8       Ignored.
  10190.             HT            9       Ignored.
  10191.             LF            10      Causes the cursor to move down one
  10192.                                   line in the current column. If the
  10193.                                   cursor moves below the screen output
  10194.                                   area, the lines above the cursor move up
  10195.                                   one line, and a blank line is added to
  10196.                                   the bottom of the screen. The operation
  10197.                                   of this key is modified by the LF Effect
  10198.                                   feature selected in SETUP B.
  10199.             VT            11      Ignored.
  10200.             FF            12      Ignored.
  10201.             CR            13      Sets Alpha mode and moves the cursor
  10202.                                   back to the left margin.
  10203.             SO            14      Ignored.
  10204.             SI            15      Ignored.
  10205.             DLE           16      Ignored.
  10206.             XON           16      Restarts transmission, if stopped.
  10207.             DC2           18      Ignored.
  10208.             XOFF          19      Stops transmission until XON is received.
  10209.             DC4           20      Ignored.
  10210.             NAK           21      Ignored.
  10211.             SYN           22      Ignored.
  10212.             ETB           23      Ignored.
  10213.             CAN           24      Ignored.
  10214.             EM            25      Ignored.
  10215.             SUB           26      Ignored.
  10216.             ESC           27      Sets LCE mode.
  10217.             FS            28      Sets Point Plot mode.
  10218.             GS            29      Sets Graph mode and does a dark
  10219.                                   (invisible) vector.
  10220.             RS            30      Sets Incremental Plot mode.
  10221.             US            31      Set Alpha mode.
  10222.  
  10223.  
  10224.                   ASCII codes 32(" ") thru 127(DEL) are ignored.
  10225.  
  10226.  
  10227.           Page 150
  10228.  
  10229.  
  10230.  
  10231.  
  10232.  
  10233.  
  10234.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10235.  
  10236.  
  10237.           F.4  LCE Mode
  10238.  
  10239.  
  10240.                   LCE  mode  arms  PC-VT  to  receive  a   special  control
  10241.           character. This is similar to,  bu simpler than, the VT100 escape
  10242.           sequences.
  10243.  
  10244.                   ASCII codes from 0  to  31  are control characters. PC-VT
  10245.           responds to these characters as listed in the following table.
  10246.  
  10247.           Name            Code    Function
  10248.  
  10249.             NUL           0       Remain in LCE mode.
  10250.             SOH           1       Ignored.
  10251.             STX           2       Ignored.
  10252.             ETX           3       Ignored.
  10253.             EOT           4       Ignored.
  10254.             ENQ           5       Returns terminal status.
  10255.             ACK           6       Ignored.
  10256.             BEL           7       Causes PC-VT to beep the IBM PC speaker.
  10257.             BS            8       Causes PC-VT to move the cursor one space
  10258.                                   right. If the cursor is already in the
  10259.                                   rightmost  column,   this   character  is
  10260.           ignored.
  10261.             HT            9       Causes PC-VT to move the cursor one space
  10262.                                   left. If the cursor is already in the
  10263.                                   leftmost column, HT causes an automatic
  10264.                                   linefeed and carriage return.
  10265.             LF            10      Remains  in  LCE mode. Causes  LF  to  be
  10266.           ignored
  10267.                                   until an invalid control character or
  10268.                                   BEL is received.
  10269.             VT            11      Causes the cursor to move up one
  10270.                                   line in the current column. If the cursor
  10271.                                   is in the top line, VT wraps to the
  10272.                                   bottom line.
  10273.             FF            12      Erases Screen and Homes cursor. (PAGE)
  10274.             CR            13      Remains  in  LCE mode. Causes  CR  to  be
  10275.           ignored
  10276.                                   until an invalid control character or
  10277.                                   BEL is received.
  10278.             SO            14      Ignored.
  10279.             SI            15      Ignored.
  10280.             DLE           16      Ignored.
  10281.             DC1           17      Ignored.
  10282.             DC2           18      Rings bell and waits for the user to
  10283.                                   press any ASCII key.
  10284.             DC3           19      Ignored.
  10285.             DC4           20      Returns to VT100 emulator mode.
  10286.             NAK           21      Ignored.
  10287.             SYN           22      Ignored.
  10288.             ETB           23      Makes a hardcopy of the screen on
  10289.                                   the attached printer.
  10290.             CAN           24      Sets Bypass mode.
  10291.  
  10292.  
  10293.                                                                    Page 151
  10294.  
  10295.  
  10296.  
  10297.  
  10298.  
  10299.  
  10300.           Appendix F                                            PC-VT v10.0
  10301.  
  10302.  
  10303.             EM            25      Ignored.
  10304.             SUB           26      Sets Bypass/GIN mode.
  10305.             ESC           27      Remains in LCE mode.
  10306.             FS            28      Sets Special Point Plot mode.
  10307.             GS            29      Sets Graph mode to do a dark
  10308.                                   (invisible) vector.
  10309.             RS            30      Sets Incremental Plot mode.
  10310.             US            31      Sets Alpha mode.
  10311.  
  10312.  
  10313.                   ASCII codes 32(" ") thru 55("7") are ignored.
  10314.  
  10315.                   ASCII codes 56("8")  thru 59(";") select character sizes.
  10316.           PC-VT  supports  two  character sizes when using the IBM CGA (the
  10317.           standard 25  line  by  80  column set and a 33 line by 106 column
  10318.           set) and two  character  sizes  when  using  the  Everex  Edge or
  10319.           Hercules card (these are 43 lines  by  90 columns and 58 lines by
  10320.           120 columns generated by PC-VT  software).  The  selection  is as
  10321.           follows:
  10322.  
  10323.  
  10324.           Set     ASCII code      IBM CGA         Everex or Hercules #1
  10325.                   56("8")         25 by 80        43 by 90  (default) #2
  10326.                   57("9")         25 by 80        43 by 90 #3
  10327.                   58(":")         33 by 106       58 by 120 Capital Letters
  10328.           #4 59(";") 33 by 106 58 by 120 Capital Letters
  10329.  
  10330.                   ASCII codes 60("<") thru 62(">") are ignored.
  10331.  
  10332.                   ASCII  code  63("?")  is interpreted as a LOY code if the
  10333.           LOY option is reset in the SETUP B frame.
  10334.  
  10335.                   ASCII codes 64("@") thru 95("_") are ignored.
  10336.  
  10337.                   ASCII codes  96("`")  thru  119("w")  set  drawing  modes
  10338.           depending on their bit patterns as follows:
  10339.  
  10340.  
  10341.  
  10342.  
  10343.  
  10344.  
  10345.  
  10346.  
  10347.  
  10348.  
  10349.  
  10350.  
  10351.  
  10352.  
  10353.  
  10354.  
  10355.  
  10356.  
  10357.  
  10358.  
  10359.           Page 152
  10360.  
  10361.  
  10362.  
  10363.  
  10364.  
  10365.  
  10366.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10367.  
  10368.  
  10369.           bit 7 is always off
  10370.                   0
  10371.           bits 6 and 5 are always on
  10372.                   11
  10373.           bits 4 and 3 specify beam mode:
  10374.                   00 Focused
  10375.                   01 Defocused (not supported)
  10376.                   10 Write-Thru
  10377.                   11 not used
  10378.           bits 2, 1, and 0 specify the beam form:
  10379.                   000 Solid
  10380.                   001 Dotted
  10381.                   010 Dot-Dashed
  10382.                   011 Short-Dashed
  10383.                   100 Long-Dash
  10384.                   101 Solid
  10385.                   110 Solid
  10386.                   111 Solid
  10387.  
  10388.                   Defocused drawing mode is not supported  and  if received
  10389.           results  in  normal  vectors.  Write-Thru  mode  is  simulated by
  10390.           writing  to  the  screen in Exclusive-OR mode. That is, each time
  10391.           that  a  Write-Thru  vector  is  received,  the  vector drawn  is
  10392.           alternately drawn and then erased. This appears to the user  as a
  10393.           blinking vector. As long as an even number of  draws  occur,  the
  10394.           vector is erased at the  end.  You  can  also  use  this  for any
  10395.           general type of drawing where exclusive-or is required.
  10396.  
  10397.                   Note : exclusive-or means  that  the  point which you are
  10398.           drawing is drawn only  if  it is different from the current value
  10399.           (ON or OFF) of the point on the screen.
  10400.  
  10401.                   Some typical sequences to select drawing modes are:
  10402.  
  10403.  
  10404.           ESC `           Focused Solid
  10405.           ESC a           Focused Dotted
  10406.           ESC b           Focused Dot-Dashed
  10407.           ESC c           Focused Short-Dashed
  10408.           ESC d           Focused Long-Dashed
  10409.  
  10410.           ESC p           Write-thru Solid
  10411.           ESC q           Write-thru Dotted
  10412.           ESC r           Write-thru Dot-Dashed
  10413.           ESC s           Write-thru Short-Dashed
  10414.           ESC t           Write-thru Long-Dashed
  10415.  
  10416.                   ASCII codes 120("x") thru 126("~") are ignored.
  10417.  
  10418.                   ASCII code  127(DEL) causes the emulator to remain in LCE
  10419.           mode.
  10420.  
  10421.  
  10422.  
  10423.  
  10424.  
  10425.                                                                    Page 153
  10426.  
  10427.  
  10428.  
  10429.  
  10430.  
  10431.  
  10432.           Appendix F                                            PC-VT v10.0
  10433.  
  10434.  
  10435.  
  10436.  
  10437.  
  10438.  
  10439.  
  10440.  
  10441.  
  10442.  
  10443.  
  10444.  
  10445.  
  10446.  
  10447.  
  10448.  
  10449.  
  10450.  
  10451.  
  10452.  
  10453.  
  10454.  
  10455.  
  10456.  
  10457.  
  10458.  
  10459.  
  10460.  
  10461.  
  10462.  
  10463.  
  10464.  
  10465.  
  10466.  
  10467.  
  10468.  
  10469.  
  10470.  
  10471.  
  10472.  
  10473.  
  10474.  
  10475.  
  10476.  
  10477.  
  10478.  
  10479.  
  10480.  
  10481.  
  10482.  
  10483.  
  10484.  
  10485.  
  10486.  
  10487.  
  10488.  
  10489.  
  10490.  
  10491.           Page 154
  10492.  
  10493.  
  10494.  
  10495.  
  10496.  
  10497.  
  10498.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10499.  
  10500.  
  10501.  
  10502.  
  10503.  
  10504.  
  10505.  
  10506.  
  10507.                                      Appendix G
  10508.  
  10509.                            4014 Received Escape Sequences
  10510.  
  10511.  
  10512.  
  10513.  
  10514.                   PC-VT constantly  monitors  the  communications  line for
  10515.           these incoming escape sequences. When  they  are  received, PC-VT
  10516.           performs  the function as shown. The  escape  character  and  the
  10517.           characters which follow it  and  are part of the sequence are not
  10518.           displayed.  When  receiving (downloading) an  ASCII  file,  PC-VT
  10519.           copies  these  characters  to the PC disk file being created. The
  10520.           escape  character  is  shown below as  "ESC"  and  is  the  ASCII
  10521.           character with the value of 27.
  10522.  
  10523.           ESC SO         Not supported.
  10524.  
  10525.           ESC SI         Not supported.
  10526.  
  10527.           ESC ENQ        Report   Terminal  Status.  See  Appendix  H   for
  10528.                          definition of the response.
  10529.  
  10530.           ESC ETB        Hardcopy.  The  screen  is  copied to the attached
  10531.                          printer. LPT1 or LPT2 can be selected in the SETUP
  10532.                          B frame.  The  IBM  supplied  program GRAPHICS.COM
  10533.                          must have been run  before  you  start up PC-VT in
  10534.                          order for the Hardcopy command to work.
  10535.  
  10536.           ESC CAN        Sets  Bypass condition. PC-VT does not respond  to
  10537.                          any data echoed back from the host.
  10538.  
  10539.           ESC FF         Selects  Alpha mode, erases the screen, homes  the
  10540.                          cursor and clears Bypass condition.
  10541.  
  10542.           ESC SUB        Sets  GIN mode. A crosshair pointer is  displayed.
  10543.                          You can position it  and  cause  PC-VT to send the
  10544.                          coordinates  of  that position to  the  host.  The
  10545.                          Appendix  H  shows  the  format of the coordinates
  10546.                          sent to the host.
  10547.  
  10548.           ESC FS         Sets Point Plot mode.
  10549.  
  10550.           ESC CR         Disables response to  carriage return until BEL or
  10551.                          an invalid control code is received.
  10552.  
  10553.           ESC LF         Disables  response  to linefeed until  BEL  or  an
  10554.                          invalid control code is received.
  10555.  
  10556.  
  10557.                                                                    Page 155
  10558.  
  10559.  
  10560.  
  10561.  
  10562.  
  10563.  
  10564.           Appendix G                                            PC-VT v10.0
  10565.  
  10566.  
  10567.           ESC DEL, ESC NUL, ESC CR, ESC LF, ESC ESC
  10568.                          These five sequences set  LCE  mode.  In addition,
  10569.                          ESC  CR  and  ESC  LF  affect  PC-VT  response  to
  10570.                          carriage return and linefeed.
  10571.  
  10572.           ESC ?          4014  terminals  have  a  "DEL implies LOY" option
  10573.                          which is  supported  in  SETUP  B  in  PC-VT. This
  10574.                          option allows the DEL control  character  to  be a
  10575.                          LOY value in coordinate specifications. Since this
  10576.                          usage  may  conflict  with some operating system's
  10577.                          usage  of  DEL,  4014  mode  accepts  this  escape
  10578.                          sequence as a substitute  for  the  LOY coordinate
  10579.                          value of DEL.
  10580.  
  10581.           ESC BEL, ESC BS, ESC HT, ESC VT, ESC GS, ESC RS, ESC US
  10582.                          These  sequences perform the same function as  the
  10583.                          second character without the escape character.
  10584.  
  10585.           ESC DC2        This  special escape sequence was added in  PC-VT.
  10586.                          Upon receipt, PC-VT sounds the PC's bell  and then
  10587.                          waits for the user  to  press  any ASCII key. This
  10588.                          pause can also be  done  using  the  standard 4014
  10589.                          commands by going back into Alpha mode and reading
  10590.                          the keyboard. This method  is  useful  if  you are
  10591.                          drawing a sequence of  graphs  which  the  user is
  10592.                          capturing for  later  review.  When  the  user  is
  10593.                          viewing  graphs  using  the  =v option of Transmit
  10594.                          File, this  sequence is the only way to have PC-VT
  10595.                          automatically pause between graphs.
  10596.  
  10597.           ESC DC4        This  special escape sequence was added in  PC-VT.
  10598.                          Upon  receipt,  PC-VT  switches  back  into  VT100
  10599.                          emulator mode.
  10600.  
  10601.  
  10602.  
  10603.  
  10604.  
  10605.  
  10606.  
  10607.  
  10608.  
  10609.  
  10610.  
  10611.  
  10612.  
  10613.  
  10614.  
  10615.  
  10616.  
  10617.  
  10618.  
  10619.  
  10620.  
  10621.  
  10622.  
  10623.           Page 156
  10624.  
  10625.  
  10626.  
  10627.  
  10628.  
  10629.  
  10630.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10631.  
  10632.  
  10633.  
  10634.  
  10635.  
  10636.  
  10637.  
  10638.  
  10639.                                      Appendix H
  10640.  
  10641.                          4014 Responses to Escape Sequences
  10642.  
  10643.  
  10644.                   PC-VT  responds to several control characters and  escape
  10645.           sequences. All sequences which return graphics coordinates always
  10646.           return 10 bit  coordinates  in  the  range of 0 to 1023 Tekpoints
  10647.           even if the host has been sending 12 bit coordinates.
  10648.  
  10649.  
  10650.           Elicitor                Response
  10651.  
  10652.           ESC ENQ
  10653.  
  10654.           Creates one of these GIN mode situations:
  10655.  
  10656.           GIN Mode 1 - Alpha Cursor / Graph Beam Position Report
  10657.  
  10658.           1. Causes terminal status and coordinates of lower left corner of
  10659.           the Alpha cursor to be sent to the computer if received while the
  10660.           terminal is in Alpha mode. Emulator remains in Alpha mode.
  10661.  
  10662.  
  10663.           Byte 1  X  0  1  0  0  0  0  1  Terminal status byte
  10664.           Byte 2  X  0  1  x9 x8 x7 x6 x5 HIX
  10665.           Byte 3  X  0  1  x4 x3 x2 x1 x0 LOX
  10666.           Byte 4  X  0  1  y9 y8 y7 y6 y5 HIY
  10667.           Byte 5  X  0  1  y4 y3 y2 y1 y0 LOY
  10668.           Byte 6  X  0  0  0  1  1  0  1  CR  (if selected by option)
  10669.  
  10670.           2. Causes terminal status and  coordinates of the display beam to
  10671.           be sent to  the  host  if  received while in Graph mode. Emulator
  10672.           remains in Graph mode.
  10673.  
  10674.  
  10675.           Byte 1  X  0  1  0  1  0  0  1  Terminal status byte
  10676.           Byte 2  X  0  1  x9 x8 x7 x6 x5 HIX
  10677.           Byte 3  X  0  1  x4 x3 x2 x1 x0 LOX
  10678.           Byte 4  X  0  1  y9 y8 y7 y6 y5 HIY
  10679.           Byte 5  X  0  1  y4 y3 y2 y1 y0 LOY
  10680.           Byte 6  X  0  0  0  1  1  0  1  CR  (if selected by option)
  10681.  
  10682.           PC-VT follows the cursor or beam position with the GIN terminator
  10683.           selected the SETUP B frame then return to Graph mode. Polling the
  10684.           terminal with ESC  ENQ  immediately following a hard copy request
  10685.           results in a terminal response after copying is completed.
  10686.  
  10687.  
  10688.  
  10689.                                                                    Page 157
  10690.  
  10691.  
  10692.  
  10693.  
  10694.  
  10695.  
  10696.           Appendix H                                            PC-VT v10.0
  10697.  
  10698.  
  10699.                   Where the terminal status byte is:
  10700.  
  10701.  
  10702.           Bit     Default         Meaning
  10703.                   Alpha Graph
  10704.            7      0     0         none but must be 0
  10705.            6      0     0         none but must be 0
  10706.            5      1     1         none but must be 1
  10707.            4      0     0         0 indicates hardcopy unit is available
  10708.            3      0     1         0=Alpha mode, 1=Graph mode is in effect
  10709.            2      0     0         0 indicates Graph mode exists
  10710.            1      0     0         0 indicates Margin 1 is in effect
  10711.            0      1     1         0 indicates an auxiliary unit is
  10712.                                     connected
  10713.  
  10714.           GIN Mode 2 - Immediate position report of crosshair pointer
  10715.  
  10716.           Requires an ESC SUB  first  to  display  the crosshair pointer in
  10717.           Graph  mode then a ESC ENQ. Sends the  current  position  of  the
  10718.           crosshair  pointer.  In  this case, return to  Alpha  mode  after
  10719.           transmission.
  10720.  
  10721.  
  10722.           Send:
  10723.           Byte 1  X  0  1  x9 x8 x7 x6 x5 HIX
  10724.           Byte 2  X  0  1  x4 x3 x2 x1 x0 LOX
  10725.           Byte 3  X  0  1  y9 y8 y7 y6 y5 HIY
  10726.           Byte 4  X  0  1  y4 y3 y2 y1 y0 LOY
  10727.           Byte 5  X  0  0  0  1  1  0  1  CR  (if selected by option)
  10728.  
  10729.           Elicitor                Response ESC SUB
  10730.  
  10731.           GIN Mode 3 - Interactive pointer position reporting
  10732.  
  10733.           ESC SUB displays the crosshair pointer in Graph mode. Hitting any
  10734.           keypad  arrow  key  causes the pointer to move. Hitting any ASCII
  10735.           key causes the program to send the following :
  10736.  
  10737.             1.  the ASCII code of the key pressed,
  10738.  
  10739.             2.  the current position of the crosshair pointer, and
  10740.  
  10741.             3.  GIN terminator as selected in the SETUP B frame.
  10742.  
  10743.           In this case, PC-VT returns to Alpha mode after transmission.
  10744.  
  10745.  
  10746.           Send:
  10747.           Byte 1  X  X  X  X  X  X  X  X  Key Pressed
  10748.           Byte 2  X  0  1  x9 x8 x7 x6 x5 HI X
  10749.           Byte 3  X  0  1  x4 x3 x2 x1 x0 LO X
  10750.           Byte 4  X  0  1  y9 y8 y7 y6 y5 HI Y
  10751.           Byte 5  X  0  1  y4 y3 y2 y1 y0 LO Y
  10752.           Byte 6  X  0  0  0  1  1  0  1  CR  (if selected by option)
  10753.  
  10754.  
  10755.           Page 158
  10756.  
  10757.  
  10758.  
  10759.  
  10760.  
  10761.  
  10762.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10763.  
  10764.  
  10765.  
  10766.  
  10767.  
  10768.  
  10769.  
  10770.  
  10771.  
  10772.  
  10773.  
  10774.  
  10775.  
  10776.  
  10777.  
  10778.  
  10779.  
  10780.  
  10781.  
  10782.  
  10783.  
  10784.  
  10785.  
  10786.  
  10787.  
  10788.  
  10789.  
  10790.  
  10791.  
  10792.  
  10793.  
  10794.  
  10795.  
  10796.  
  10797.  
  10798.  
  10799.  
  10800.  
  10801.  
  10802.  
  10803.  
  10804.  
  10805.  
  10806.  
  10807.  
  10808.  
  10809.  
  10810.  
  10811.  
  10812.  
  10813.  
  10814.  
  10815.  
  10816.  
  10817.  
  10818.  
  10819.  
  10820.  
  10821.                                                                    Page 159
  10822.  
  10823.  
  10824.  
  10825.  
  10826.  
  10827.  
  10828.           Appendix I                                            PC-VT v10.0
  10829.  
  10830.  
  10831.           This mode  is  also  ended  by receipt of a CR, ESC FF,or ESC ENQ
  10832.           from the host or if the user presses  the  keyboard  PAGE  key or
  10833.           RESET key.
  10834.  
  10835.  
  10836.  
  10837.  
  10838.  
  10839.  
  10840.                                      Appendix I
  10841.  
  10842.                   4014 Special Shift, ALT and CTRL Key Definitions
  10843.  
  10844.  
  10845.                   In  4014 mode, PC-VT uses ALT-F  to  startup  the  PC-DOS
  10846.           command processor, ALT-Z to send a hangup command  to  the modem,
  10847.           and ALT-H to start the HELP facility.
  10848.  
  10849.                   Additionally,  several  special  Shift,  ALT and CTRL key
  10850.           commands  are  available   to   the  user  of  PC-VT.  They  were
  10851.           implemented to aid in the debug of this program.  Most  of  these
  10852.           are useful only under very  special circumstances but some may be
  10853.           of general use. To  use  these commands, hold down the Shift, ALT
  10854.           or CTRL key and at the same time  depress  the  key  listed. They
  10855.           work only in the 4014  communications frame. Other than the above
  10856.           mentioned keys, no claims or guarantees are made about these keys
  10857.           and you use them at your own risk.
  10858.  
  10859.           ALT Key plus    Function
  10860.  
  10861.           E              Sets local echo on.
  10862.  
  10863.           Y              Sets Point Plot mode.
  10864.  
  10865.           U              Sets LCE mode.
  10866.  
  10867.           I              Sets Special Point Plot mode.
  10868.  
  10869.           O              Sets Graph mode.
  10870.  
  10871.           P              Sends   a  formfeed  character  to  the   attached
  10872.                          printer.
  10873.  
  10874.           F              Starts up a second copy of COMMAND.COM.
  10875.  
  10876.           G              Sets Bypass/GIN mode.
  10877.  
  10878.           H              Starts up the HELP facility.
  10879.  
  10880.           J              Terminates Graph mode and goes to Alpha mode.
  10881.  
  10882.           K              Starts up the KERMIT file transfer program.
  10883.  
  10884.           L              Sends cursor position report.
  10885.  
  10886.  
  10887.           Page 160
  10888.  
  10889.  
  10890.  
  10891.  
  10892.  
  10893.  
  10894.           PC-VT v10.0                                 VT100 & 4014 Emulator
  10895.  
  10896.  
  10897.           Z              Hangs up the phone with a Hayes  compatible hangup
  10898.                          sequence.
  10899.  
  10900.           V              Returns  to  VT100  emulator  mode. Same effect as
  10901.                          pressing the F1 key.
  10902.  
  10903.           B              Sets Incremental Plot mode.
  10904.  
  10905.           N              Sets Alpha mode.
  10906.  
  10907.           M              Terminates Graph mode and sets Alpha mode.
  10908.  
  10909.  
  10910.           CTRL Key plus   Function
  10911.  
  10912.           @              Sends an ASCII 0 (NUL) character to the host.
  10913.  
  10914.           Shift Key plus  Function
  10915.  
  10916.           F1             Sets drawing mode to solid.
  10917.  
  10918.           F2             Sets drawing mode to dotted.
  10919.  
  10920.           F3             Sets drawing mode to dot-dashed.
  10921.  
  10922.           F4             Sets drawing mode to short-dash.
  10923.  
  10924.           F5             Sets drawing mode to long-dash.
  10925.  
  10926.           F6             Sets #1 character set.
  10927.  
  10928.           F7             Sets #2 character set.
  10929.  
  10930.           F8             Sets #3 character set.
  10931.  
  10932.           F9             Sets #4 character set.
  10933.  
  10934.  
  10935.  
  10936.  
  10937.  
  10938.  
  10939.  
  10940.  
  10941.  
  10942.  
  10943.  
  10944.  
  10945.  
  10946.  
  10947.  
  10948.  
  10949.  
  10950.  
  10951.  
  10952.  
  10953.                                                                    Page 161
  10954.  
  10955.  
  10956.  
  10957.  
  10958.  
  10959.  
  10960.           Appendix I                                            PC-VT v10.0
  10961.  
  10962.  
  10963.  
  10964.  
  10965.  
  10966.  
  10967.  
  10968.  
  10969.  
  10970.  
  10971.  
  10972.  
  10973.  
  10974.  
  10975.  
  10976.  
  10977.  
  10978.  
  10979.  
  10980.  
  10981.  
  10982.  
  10983.  
  10984.  
  10985.  
  10986.  
  10987.  
  10988.  
  10989.  
  10990.  
  10991.  
  10992.  
  10993.  
  10994.  
  10995.  
  10996.  
  10997.  
  10998.  
  10999.  
  11000.  
  11001.  
  11002.  
  11003.  
  11004.  
  11005.  
  11006.  
  11007.  
  11008.  
  11009.  
  11010.  
  11011.  
  11012.  
  11013.  
  11014.  
  11015.  
  11016.  
  11017.  
  11018.  
  11019.           Page 162
  11020.  
  11021.  
  11022.  
  11023.  
  11024.  
  11025.  
  11026.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11027.  
  11028.  
  11029.  
  11030.  
  11031.  
  11032.  
  11033.  
  11034.  
  11035.                                      Appendix J
  11036.  
  11037.                                PC-VT Technical Details
  11038.  
  11039.  
  11040.                   This  appendix  describes  some  of  the  details  of the
  11041.           implementation of PC-VT for the user who wishes  to  interface to
  11042.           the program in some non-standard way.
  11043.  
  11044.                   PC-VT has been tested on DOS 2.0, 2.1, 3.0,  and  3.1  on
  11045.           the IBM PC, the IBM PCXT,  the  IBM  PCAT and the IBM PCjr. PC-VT
  11046.           has not been tested on any  compatible  nor has it been tested on
  11047.           any system with DOS "patches"  or auxiliary programs. It does not
  11048.           operate with DOS 1.0 or 1.1.
  11049.  
  11050.  
  11051.           J.1  Details
  11052.  
  11053.  
  11054.  
  11055.  
  11056.                                BIOS and DOS Calls Used
  11057.  
  11058.  
  11059.                   In general, PC-VT uses  BIOS  calls  instead of DOS calls
  11060.           where ever possible. BIOS calls used by PC-VT:
  11061.  
  11062.           10H     to handle the display of characters and control
  11063.                   sequences while communicating with the host.
  11064.           11H     to determine the type of monitor on the system
  11065.                   and to determine if a line printer is present.
  11066.           14H     to initialize the COM port.
  11067.           16H     to do keyboard input and to look at the
  11068.                   CAPS LOCK, NUM LOCK, and SCROLL LOCK key
  11069.                   status.
  11070.           17H     to get the printer status and to print
  11071.                   characters.
  11072.           1AH     to read the binary time of day clock.
  11073.  
  11074.  
  11075.  
  11076.  
  11077.  
  11078.  
  11079.  
  11080.  
  11081.  
  11082.  
  11083.  
  11084.  
  11085.                                                                    Page 163
  11086.  
  11087.  
  11088.  
  11089.  
  11090.  
  11091.  
  11092.           Appendix J                                            PC-VT v10.0
  11093.  
  11094.  
  11095.                   DOS calls used by PC-VT:
  11096.  
  11097.           21H     the general DOS utility call with AH equal to
  11098.                   09H     to display error messages on the screen.
  11099.                   19H     to get the current default drive.
  11100.                   1AH     to set Disk Transfer Addresses.
  11101.                   25H     to set the interrupt vectors for the
  11102.                           COM port, the critical error handler
  11103.                           and the CTRL-BREAK key.
  11104.                   2CH     to get the time of day.
  11105.                   2EH     to set VERIFY on.
  11106.                   30H     to determine the DOS version number.
  11107.                   33H     to set/clear BREAK checking.
  11108.                   3CH     to create a file with a path name.
  11109.                   3DH     to open a file with a path name.
  11110.                   3EH     to close a file with a path name.
  11111.                   3FH     to read from a file with a path name.
  11112.                   40H     to write to a file with a path name.
  11113.                   41H     to delete a file with a path name.
  11114.                   47H     to get the current default directory.
  11115.                   48H     to allocate memory for HELP and screen
  11116.                           saving.
  11117.                   4BH     to start up COMMAND.COM and KERMIT.COM.
  11118.                   4EH     to check for the presence of a file
  11119.                           with a path name.
  11120.                   54H     to determine the state of the VERIFY
  11121.                           switch.
  11122.           23H     to terminate the program and restore the
  11123.                   CTRL-BREAK address in DOS. This is the "normal"
  11124.                   way to terminate PC-VT.
  11125.  
  11126.                   An error in either DOS or the BIOS code causes  a problem
  11127.           with the cursor. When PC-VT starts, it cannot ascertain the shape
  11128.           of  the  cursor  due to this error. Although PC-VT is able to use
  11129.           either the underline or block cursor, it may not be able to reset
  11130.           the  cursor  to  the original size  upon  exit.  This  will  work
  11131.           correctly when IBM corrects the problem.
  11132.  
  11133.                   PC-VT does not "look"  into  DOS  directly for any reason
  11134.           with the exception of finding the COM1 and COM2 port address. PC-
  11135.           VT should be compatible with all future releases of DOS.
  11136.  
  11137.  
  11138.  
  11139.  
  11140.                                    COM Port Usage
  11141.  
  11142.  
  11143.                   In  order  to  get  the  highest speed out of the  RS-232
  11144.           ports, PC-VT  does direct input/output to those ports. PC-VT uses
  11145.           I/O  addresses  starting  at 3F8H for COM 1 and at 2F8H for COM2.
  11146.           PC-VT gets these addresses  from  DOS by looking at the two words
  11147.           starting at address 400 (segmented address 40:0) for the starting
  11148.           port addresses for  COM1  and COM2 respectively.Note that the IBM
  11149.  
  11150.  
  11151.           Page 164
  11152.  
  11153.  
  11154.  
  11155.  
  11156.  
  11157.  
  11158.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11159.  
  11160.  
  11161.           PCjr does  not  assign  COM  ports like the PC. PC-VT has to do a
  11162.           little special work but it keeps them straight  (jr  switches the
  11163.           addresses if the internal modem is installed).
  11164.  
  11165.                   PC-VT sends a BREAK to the  host  by setting bit 6 of the
  11166.           RS-232 Port's Line Control Register for at least one-half second.
  11167.           The bit is then cleared.
  11168.  
  11169.                   PC-VT  handles  ASCII  characters  for codes greater than
  11170.           127.This works only when  the  COM port is initialized for 8 bits
  11171.           of data transfer. If  a  code greater than 127 is received, PC-VT
  11172.           can display the character  defined  in  the IBM documentation. In
  11173.           this  way,  PC-VT  is compatible with RBBS  systems  using  these
  11174.           extended  characters  while  maintaining  compatibility  with  VT
  11175.           terminals. The "256 char" bit must be set in the SETUP  frame for
  11176.           these extended characters to be displayed. Some hosts don't strip
  11177.           this  8th  bit  even when communicating with  plain  ASCII.  This
  11178.           causes  some  unusual  behavior.  Be  careful when you  use  this
  11179.           feature.
  11180.  
  11181.                   PC-VT also  does  direct  I/O  to  the  8259 Programmable
  11182.           Interrupt Controller  (PIC). It uses port address 21H for reading
  11183.           the interrupt source and address 20H for clearing that interrupt.
  11184.  
  11185.  
  11186.  
  11187.  
  11188.                                      Modem Usage
  11189.  
  11190.  
  11191.                   If you use an external modem or a  direct  connect, PC-VT
  11192.           does not require that all 25 lines of the DB-25 connector  on the
  11193.           COM port be connected.
  11194.  
  11195.                   Actually, only pin  2  (transmit  data),  pin  3 (receive
  11196.           data),  and  pin  7 (signal ground) need be connected. PC-VT does
  11197.           not  use  Clear  to Send (CTS), Data Set Ready (DSR) or any other
  11198.           modem status line.  This  is  the  FDX A mode of VT100 operation.
  11199.           Since  some  modems  require a basic handshake with the COM port,
  11200.           PC-VT sends Data Terminal Ready (DTR) and Ready to Send (RTS) out
  11201.           of the COM port. These 2 lines are not cleared when you terminate
  11202.           PC-VT,  permitting the connection to be maintained  while  you go
  11203.           back to DOS by terminating PC-VT. A better way to get into DOS is
  11204.           to  use  the  ALT-F  key  - this method keeps the  communications
  11205.           buffer actively monitoring  the  line.  Be  careful  because this
  11206.           means  that the phone does not hang  up  automatically  when  you
  11207.           terminate PC-VT. If you have a Hayes compatible modem, you should
  11208.           use  the  F5 function of the DIALING  frame  or  ALT-Z  from  the
  11209.           communications  frame  to  be sure. If your modem is manual, then
  11210.           you must physically hang up the phone.
  11211.  
  11212.                   Some installations require that the terminal drop  DTR as
  11213.           a  break  signal  to the host. PC-VT toggles the state of the DTR
  11214.           line when  you  press  F2.  It is initially set to a 1. The first
  11215.  
  11216.  
  11217.                                                                    Page 165
  11218.  
  11219.  
  11220.  
  11221.  
  11222.  
  11223.  
  11224.           Appendix J                                            PC-VT v10.0
  11225.  
  11226.  
  11227.           press of F2 clears it to a 0 and the next press sets it back to a
  11228.           1.
  11229.  
  11230.                   Receive parity checking, if set, checks not  only receive
  11231.           parity but also data overrun and framing errors. PC-VT puts a '!'
  11232.           in  the  buffer  when  a  character with bad parity is  received.
  11233.           Parity checking is normally off and can be enabled in the SETUP B
  11234.           frame.
  11235.  
  11236.  
  11237.  
  11238.  
  11239.                                 Communications Buffer
  11240.  
  11241.  
  11242.                   The communications buffer in PC-VT is 2048  bytes long.To
  11243.           prevent buffer overflow, the  XON/XOFF  support  sends  XOFF when
  11244.           1536 characters are in the buffer (the 75% point of  the buffer).
  11245.           Then, XON  is  sent  when  the  buffer  backlog is reduced to 204
  11246.           characters (the 10% point of the buffer). If the host ignores the
  11247.           XOFF character transmitted, PC-VT  displays  a  '#'character when
  11248.           the buffer overflows. All characters received while the buffer is
  11249.           in the overflow condition are discarded.
  11250.  
  11251.                   The  buffer  size  can  be  reduced  to  256 bytes  by  a
  11252.           selection in the SETUP B frame. See the index for  "Buffer Size".
  11253.           The smaller buffer gives  you  faster  response to CTRL-C, CTRL-O
  11254.           and CTRL-Y but some programs which do not handle XON/XOFF may not
  11255.           work as well.
  11256.  
  11257.  
  11258.  
  11259.  
  11260.                                        VMS 4.0
  11261.  
  11262.  
  11263.                   Some users of PC-VT have  reported  problems  with XMODEM
  11264.           under VMS version 4.0. Due to some change  made  by  DEC  in that
  11265.           release,  an  additional  parameter must be set using the VMS SET
  11266.           TERM  command.  For  each TT line that to be used with PC-VT, you
  11267.           must permanently set the Alternate Type Ahead Buffer.
  11268.  
  11269.                   The VMS command to do this is:
  11270.  
  11271.           SET TERM /PERM/ALTYPEAHD
  11272.  
  11273.                   This specification takes effect at your next log in. This
  11274.           command may have to be  performed by your VMS system programmers.
  11275.           Contact your DEC representative for more information.
  11276.  
  11277.  
  11278.  
  11279.  
  11280.  
  11281.  
  11282.  
  11283.           Page 166
  11284.  
  11285.  
  11286.  
  11287.  
  11288.  
  11289.  
  11290.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11291.  
  11292.  
  11293.                             "Snow" or Fast Screen Update
  11294.  
  11295.  
  11296.                   PC-VT  can  use  a "snow" screen update  with  the  color
  11297.           graphics  adapter.  Normally,  when you do a screen output to the
  11298.           color graphics adapter, the BIOS  waits  for  the  raster retrace
  11299.           before writing into  the  video memory. This would severely limit
  11300.           the baud rate to about 4800 baud. If you select the "snow" update
  11301.           option on the SETUP  B  frame,  PC-VT  writes directly into video
  11302.           memory  without  waiting  for  the  retrace  time.   This  causes
  11303.           conflicts between  the hardware reading the video memory in order
  11304.           to  display its contents and the writing of  new  data  into  the
  11305.           memory. The conflict appears  as  small  white  dots all over the
  11306.           screen. This is "snow". With  this feature on, PC-VT handles 9600
  11307.           baud. This is not an issue with the IBM  Monochrome  adapter  and
  11308.           Display as that video  memory  is dual-ported and can be read and
  11309.           written at the same time. PC-VT handles 9600 baud  with  the  IBM
  11310.           Monochrome adapter.
  11311.  
  11312.                   If you don't like the snow update feature but would still
  11313.           like  PC-VT to use direct memory access  (DMA)  when  saving  and
  11314.           restoring frames and when switching  to  reverse  video,  you can
  11315.           select the DMA option  in  the SETUP B frame. With this selected,
  11316.           normal output to the screen be snow-free. This  was  a compromise
  11317.           between full snow update and none at all.
  11318.  
  11319.  
  11320.  
  11321.  
  11322.                                        XMODEM
  11323.  
  11324.  
  11325.                   With XMODEM file transfer with  CRC  checking,  PC-VT has
  11326.           made a commitment to accurate  file transfer. In support of this,
  11327.           PC-VT sets the VERIFY switch on during its run. The VERIFY switch
  11328.           is restored to its initial value when PC-VT terminates.
  11329.  
  11330.                   When  running XMODEM,  PC-VT  automatically  changes  the
  11331.           communications to 8 data  bits,  no parity, 1 stop bit (8-N-1) if
  11332.           you are not already set at that protocol. PC-VT then restores the
  11333.           protocol to your value when the XMODEM transfer is complete.
  11334.  
  11335.                   Public  domain  programs are available  with  the  XMODEM
  11336.           program written for the  VAX  running VMS and the VAX running 4.2
  11337.           UNIX. Check with your local computer club.
  11338.  
  11339.  
  11340.  
  11341.  
  11342.                                         PCjr
  11343.  
  11344.  
  11345.                   A  comment on the operation of PC-VT  on  the  IBM  PCjr:
  11346.           There are some hardware differences which you should be aware of.
  11347.  
  11348.  
  11349.                                                                    Page 167
  11350.  
  11351.  
  11352.  
  11353.  
  11354.  
  11355.  
  11356.           Appendix J                                            PC-VT v10.0
  11357.  
  11358.  
  11359.           If  you  are  using  the  PCjr  internal  modem for  XMODEM  data
  11360.           transfer, don't forget that you must set the modem with a "^NF 4"
  11361.           command.  When  the  PCjr  is  doing  a  disk access,  all  other
  11362.           interrupts are turned off. This means that if data comes down the
  11363.           communications line, it is lost.  For  this  reason,  using ASCII
  11364.           file  transfer  for  receiving  a  file is not  recommended.  Use
  11365.           XMODEM. If you must receive a file using ASCII,  PC-VT  sends  an
  11366.           XOFF  while the PCjr is writing to disk and sends an XON once the
  11367.           machine  is ready to process interrupts  again.  Sending  a  file
  11368.           using the ASCII file transfer method works ok.  The  dialer works
  11369.           fine if you  change  the  modem  dialing command from ATDT to the
  11370.           characters  required  by  the  PCjr  modem  (you  need  the  PCjr
  11371.           Technical Reference Manual to  completely  understand  the PCjr's
  11372.           modem).
  11373.  
  11374.                   One other problem that some users have with PC-VT running
  11375.           on the PCjr is with the F8, F9, and F10 keys.  All  of  the other
  11376.           function keys work ok on the PCjr, and of course they all work ok
  11377.           on the PC and the AT. The problem  is  that  when  you want to do
  11378.           something like call up the DIALING frame, you have to press CTRL-
  11379.           F9. Some PCjr's ignore this key because BIOS never even sends the
  11380.           program an interrupt when  you  have pressed the key. If you have
  11381.           one  of  these  PCjrs, you have  one  alternative.  You  use  the
  11382.           Function Shift feature of the PCjr described on page 5-35  of the
  11383.           PCjr Technical Reference Manual:
  11384.  
  11385.                 "Function Lock
  11386.  
  11387.                Concurrently pressing first the Fn key  and  Shift key,
  11388.                and then pressing the Esc key causes keys 2 thru  11 to
  11389.                shift to their 'Function' states and remain there until
  11390.                the same combination is pressed again."
  11391.  
  11392.                   When IBM refers to keys 2 thru 11 they  mean  the  number
  11393.           keys on the top row of the keyboard: 1 thru 0. To get CTRL-F8, go
  11394.           into the 'Function Lock' mode, then press the Ctrl key and  the 8
  11395.           key and then go back out of 'Function Lock' mode.
  11396.  
  11397.                   There are  three alternate keys which you can use instead
  11398.           of CTRL-F8,9,and 10.
  11399.  
  11400.           Instead of:             Use: CTRL-F8
  11401.                                   ALT-C CTRL-F9
  11402.                                   ALT-V CTRL-F10
  11403.                                   ALT-O
  11404.  
  11405.  
  11406.           J.2  HELP Customization
  11407.  
  11408.  
  11409.                   The HELP file  is  a  text  file which PC-VT reads into a
  11410.           segment of  dynamically  allocated  memory  when  the  user first
  11411.           presses ALT-H. Subsequent presses  of  the  HELP  key does not do
  11412.           disk reads. HELP is context sensitive; that is, the HELP  you get
  11413.  
  11414.  
  11415.           Page 168
  11416.  
  11417.  
  11418.  
  11419.  
  11420.  
  11421.  
  11422.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11423.  
  11424.  
  11425.           is  related  to  the  part  of  PC-VT  which  you  are  currently
  11426.           executing.
  11427.  
  11428.                   The  text  file  can  be  thought of as broken down  into
  11429.           pages. The pages have a subject number assigned to them. When you
  11430.           ask for HELP in PC-VT, a subject number  is  passed  to  the HELP
  11431.           program. HELP then displays the pages which provide  HELP  on the
  11432.           subject. The subject numbers are:
  11433.  
  11434.                   '0'     display this page always
  11435.                   '1'     VMS specific page from Main Program
  11436.                   '2'     UNIX specific page from Main Program
  11437.                   '3'     PC-VT Main Program specific page
  11438.                   '4'     SETUP A specific page
  11439.                   '5'     DIALER specific page
  11440.                   '6'     MACRO specific page
  11441.                   '7'     SETUP B specific page
  11442.                   '8'     4014 specific page
  11443.  
  11444.  
  11445.                   The dollar sign  character  (ASCII 36) is the page break.
  11446.           It is followed by the  subject number. Therefore, the dollar sign
  11447.           cannot appear in any of the  HELP  text. There should be a CTRL-Z
  11448.           at the end of the file.
  11449.  
  11450.                   Each  time  that  the user presses PgUp or PgDn, the HELP
  11451.           information is scrolled either one page back or one page forward.
  11452.           Pressing the Esc key returns  you to whatever frame was displayed
  11453.           when you first asked for HELP.
  11454.  
  11455.                   The  HELP  information  displays  with   bold,  blinking,
  11456.           reverse video and underline  attributes.  If  for any reason, you
  11457.           want to change them, here is  how  they are coded in the HELP.DAT
  11458.           file.
  11459.  
  11460.                   The true video attribute  is  actually  put into the file
  11461.           preceded by a CTRL-Backspace character. The attributes are:
  11462.  
  11463.                           Normal     Intensified Blinking    Intensified
  11464.                                                              & Blinking
  11465.           White on Black  07h CTRL-G 0Fh CTRL-O  87h ALT-135 8Fh ALT-143
  11466.           Underline       01h CTRL-A 09h CTRL-I  81h ALT-130 89h ALT-137
  11467.           Black on White  70h P      78h x       F0h ALT-240 F8h ALT-248
  11468.  
  11469.                   So to get a normal video (white on black)  blink,  put  a
  11470.           CTRL-Backspace  followed  by  an 87h into the file. The ALT codes
  11471.           are generated by holding down the ALT key and pressing  the three
  11472.           digit keys on the keypad. Depending on which text editor you use,
  11473.           you may have to enter these codes in different ways.
  11474.  
  11475.                   So whenever PC-VT sees  a  CTRL-Backspace  (ASCII  127 or
  11476.           FFH) in  the  file,  it  reads  the  next character and uses that
  11477.           character as the attribute on the call to BIOS via interrupt 10h.
  11478.           It uses that attribute  until  you change it to some other value.
  11479.  
  11480.  
  11481.                                                                    Page 169
  11482.  
  11483.  
  11484.  
  11485.  
  11486.  
  11487.  
  11488.           Appendix J                                            PC-VT v10.0
  11489.  
  11490.  
  11491.           So  if  you want regular white on  black  again,  enter  a  CTRL-
  11492.           Backspace followed by a  CTRL-G.  With this, you can add color to
  11493.           the HELP screens also.
  11494.  
  11495.                   Of  course,  you  use  this   at  your  own  risk  -  its
  11496.           complicated.
  11497.  
  11498.  
  11499.           J.3  Miscellaneous
  11500.  
  11501.  
  11502.                   Since the IBM  PC  does  not  have  some  of  the special
  11503.           character and line drawing set characters, PC-VT makes use of the
  11504.           best available representation. See the description for the "ESC )
  11505.           0" sequence for the list of the selected representation.
  11506.  
  11507.                   The NUM LOCK key acts per the IBM documentation.
  11508.  
  11509.                   Undefined   or  illegal  escape  control  sequences   are
  11510.           ignored.
  11511.  
  11512.                   PC-VT controls the speaker to cause it to  beep  by doing
  11513.           direct I/O to addresses 42H,43H, and 61H.
  11514.  
  11515.                   The printer  serves  as  a  capture  device  only. Escape
  11516.           sequences are not sent to the printer. This is different than the
  11517.           VT100  attached printer. PC-VT has a  speical  sequence  to  send
  11518.           control  characters to the printer, look  at  the  section  below
  11519.           titled "Printer Support".
  11520.  
  11521.                   The  ALT-F  key  calls  up  another  copy  of COMMAND.COM
  11522.           leaving PC-VT in  memory  and asleep. The memory remains occupied
  11523.           and the interrupt driven communications buffer remains  active so
  11524.           that any characters which come down the line  are  buffered. Once
  11525.           you get the new DOS prompt,  you  can do almost anything that you
  11526.           can  do  from  the regular DOS prompt. When you wish to return to
  11527.           PC-VT, simply type the word: exit. PC-VT awakens and restores the
  11528.           screen. Any characters which have  come  down  the communications
  11529.           line while DOS was running are displayed but only if you  did not
  11530.           run  a  communications  program using the same COM port while you
  11531.           were in DOS.
  11532.  
  11533.                   In case the user executed  a  "BREAK  ON"  command, PC-VT
  11534.           resets  BREAK  checking  while  it  is running and  restores  the
  11535.           checking, if necessary, as it terminates.
  11536.  
  11537.                   PC-VT  uses  dynamic memory when  possible.  The  program
  11538.           permanently occupies about 58K bytes. For HELP, PC-VT grabs about
  11539.           23K bytes via DOS call 48H.  If  the memory is not available, the
  11540.           HELP key is ignored.  When  you  request  KERMIT, PC-VT starts up
  11541.           another copy  of COMMAND.COM and then EXECutes KERMIT.COM via DOS
  11542.           call 4BH. COMMAND.COM uses about 5K and KERMIT uses about 83K. If
  11543.           you have activated the Scroll Buffer, PC-VT allocates 32K for the
  11544.           buffer. If it  cannot  get  the  memory, the SCROLL LOCK key just
  11545.  
  11546.  
  11547.           Page 170
  11548.  
  11549.  
  11550.  
  11551.  
  11552.  
  11553.  
  11554.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11555.  
  11556.  
  11557.  
  11558.  
  11559.           ---------------------------------------------------------------------------
  11560.  
  11561.  
  11562.  
  11563.                                       ┌──────────┐
  11564.                                       │          │
  11565.                                       │          │
  11566.                                       │  KERMIT  │
  11567.                         ┌──────────┐  │          │
  11568.                         │          │  │   83K    │  ┌──────────┐
  11569.                         │  Scroll  │  │          │  │          │
  11570.                         │  Buffer  │  │          │  │          │
  11571.                         │          │  ├──────────┤  │  KERMIT  │
  11572.                         │   32K    │  │ Command  │  │          │
  11573.                         │          │  │   5K     │  │   83K    │
  11574.                         ├──────────┤  ├──────────┤  │          │
  11575.                         │  HELP    │  │  HELP    │  │          │
  11576.                         │          │  │          │  ├──────────┤
  11577.                         │   23K    │  │   23K    │  │ Command  │
  11578.                         │          │  │          │  │   5K     │
  11579.           ┌──────────┐  ├──────────┤  ├──────────┤  ├──────────┤
  11580.           │          │  │          │  │          │  │          │
  11581.           │          │  │          │  │          │  │          │
  11582.           │  PC-VT   │  │  PC-VT   │  │  PC-VT   │  │  PC-VT   │
  11583.           │          │  │          │  │          │  │          │
  11584.           │   58K    │  │   58K    │  │   58K    │  │   58K    │
  11585.           │          │  │          │  │          │  │          │
  11586.           └──────────┘  └──────────┘  └──────────┘  └──────────┘
  11587.           ┌────────────────────────────────────────────────────┐
  11588.           │                       DOS                          │
  11589.           │         The amount of memory used by DOS           │
  11590.           │ depends on its version and RAM resident software.  │
  11591.           └────────────────────────────────────────────────────┘
  11592.  
  11593.                   Figure J.1 PC-VT Memory Configuration
  11594.  
  11595.  
  11596.           ---------------------------------------------------------------------------
  11597.  
  11598.           functions as a scroll lock and does not give you  recall ability.
  11599.           By  implementing  PC-VT  in this manner, it runs on machines with
  11600.           small memory sizes but if more memory is  available,  PC-VT makes
  11601.           full use of it.
  11602.  
  11603.                   Figure J.1 shows a few of the memory configurations which
  11604.           PC-VT can set up.
  11605.  
  11606.                   PC-VT  has a switch in the SETUP  frame  which  lets  you
  11607.           select  either a VMS host or a UNIX host. If VMS is selected, PC-
  11608.           VT sets up the editing keypad and function keys  for  either  the
  11609.           EDT or EVE editor and uses  CTRL-Z  as the End of File character.
  11610.           When the UNIX mode is selected, PC-VT sets up the  editing keypad
  11611.  
  11612.  
  11613.                                                                    Page 171
  11614.  
  11615.  
  11616.  
  11617.  
  11618.  
  11619.  
  11620.           Appendix J                                            PC-VT v10.0
  11621.  
  11622.  
  11623.           for the VI editor and uses CTRL-D as the End of File indicator to
  11624.           the host.
  11625.  
  11626.                   The  color  graphics  adapter  does not handle underlined
  11627.           characters. Since the VT100 has an attribute for underline, PC-VT
  11628.           handles this in a special way. On the color graphics adapter, PC-
  11629.           VT displays underlined text as bold  or  bold/blinking selectable
  11630.           from  the  SETUP  B frame. The IBM Monochrome Display can display
  11631.           the underline attribute.
  11632.  
  11633.                   Auto   repeat   is  handled  by   the   keyboard.   PC-VT
  11634.           approximates the  repeat off mode by clearing the keyboard buffer
  11635.           on  the receipt of the auto repeat off  escape  sequence  and  by
  11636.           clearing the keyboard buffer after reading each character. Repeat
  11637.           on mode is left entirely to the keyboard and the BIOS.
  11638.  
  11639.  
  11640.           J.4  DESQview and TopView
  11641.  
  11642.  
  11643.                   PC-VT is compatible with both DESQview and TopView. PC-VT
  11644.           normally  runs  in  the  foreground  only.  By  resetting certain
  11645.           features in the SETUP B frame, PC-VT also runs in the background.
  11646.           Running  PC-VT in the background lets  you  upload  and  download
  11647.           files  while you are doing other work. If you set up PC-VT to run
  11648.           in the background, it runs a little slower when you run it in the
  11649.           foreground and some features are not be available.
  11650.  
  11651.  
  11652.           DESQview
  11653.  
  11654.  
  11655.                   The minimum memory size is 58K. In order to use HELP, set
  11656.           the memory to  81K.  To  use  the Scroll Buffer, increase that by
  11657.           32K. Under DESQview, KERMIT  and  the  second copy of COMMAND.COM
  11658.           should be run as separate programs and not from PC-VT. To use the
  11659.           4014  emulator,  the  program  must  be  set  up  to  run in  the
  11660.           foreground only.
  11661.  
  11662.                   For  DESQview,  in  order  to  run  PC-VT  in either  the
  11663.           foreground or the background,:
  11664.  
  11665.              -  Set window position to 0,0,25,80,
  11666.  
  11667.              -  In the options list, set only the "close on  exit  to  DOS"
  11668.                 option.
  11669.  
  11670.                   In  PC-VT's SETUP B frame, turn  Fast  Screen,  DMA,  and
  11671.           Scroll  Buffer off by setting their  feature  selection  bits  to
  11672.           zero.
  11673.  
  11674.                   To run PC-VT in the foreground only,:
  11675.  
  11676.              -  Set window position to 0,0,25,80,
  11677.  
  11678.  
  11679.           Page 172
  11680.  
  11681.  
  11682.  
  11683.  
  11684.  
  11685.  
  11686.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11687.  
  11688.  
  11689.              -  In the options list, set  the  "write  directly  to screen"
  11690.                 option and
  11691.                 any others that you wish.
  11692.  
  11693.                   In PC-VT's SETUP B frame, you can select any options that
  11694.           you wish including Fast Screen,  DMA,  and  Scroll  Buffer. PC-VT
  11695.           suspends  when   you   switch   to   another   program   but  the
  11696.           communications line interrupt  handler still buffers any incoming
  11697.           characters.
  11698.  
  11699.  
  11700.           TopView
  11701.  
  11702.  
  11703.                   The minimum memory size is 58K. In order to use HELP, set
  11704.           the maximum size to  81K.  To use the Scroll Buffer, increase the
  11705.           maximum  by 32K. Under TopView, KERMIT and  the  second  copy  of
  11706.           COMMAND.COM should be run as separate programs and  not  from PC-
  11707.           VT. To use the 4014 emulator, the program must be  set  up to run
  11708.           in the foreground only.
  11709.  
  11710.                   For  TopView,  in  order  to  run  PC-VT  in  either  the
  11711.           foreground or the background:
  11712.  
  11713.           Set screen type to D,
  11714.           Set window size to 25 rows and 80 columns,
  11715.           Set pages to 1,
  11716.           Set offsets to 0,0,
  11717.           Set range of software interrupt vectors swapped to 0B low and 24
  11718.           high, and
  11719.           Answer n to the last four questions.
  11720.  
  11721.                   In  PC-VT's SETUP B frame, turn  Fast  Screen,  DMA,  and
  11722.           Scroll  Buffer off by setting their  feature  selection  bits  to
  11723.           zero.
  11724.  
  11725.                   To run PC-VT in the foreground only:
  11726.  
  11727.           Set screen type to D,
  11728.           Set window size to 25 rows and 80 columns,
  11729.           Set pages to 1,
  11730.           Set offsets to 0,0,
  11731.           Set range of software interrupt vectors swapped to 0B low and 24
  11732.           high,
  11733.           Answer y to the question about writing directly to the screen,
  11734.           and
  11735.           Answer n to the last three questions.
  11736.  
  11737.                   In PC-VT's SETUP B frame, you can select any options that
  11738.           you wish including Fast Screen,  DMA,  and  Scroll  Buffer. PC-VT
  11739.           suspends  when   you   switch   to   another   program   but  the
  11740.           communications line interrupt  handler still buffers any incoming
  11741.           characters.
  11742.  
  11743.  
  11744.  
  11745.                                                                    Page 173
  11746.  
  11747.  
  11748.  
  11749.  
  11750.  
  11751.  
  11752.           Appendix J                                            PC-VT v10.0
  11753.  
  11754.  
  11755.           J.5  PC-VT Private Escape Sequences
  11756.  
  11757.  
  11758.                   For those of you into such things, PC-VT contains several
  11759.           private escape sequences which cause it to do a few  things which
  11760.           normally can only be done by pressing keys on the  keyboard (i.e.
  11761.           done  by  the  user of the program).  The  distribution  diskette
  11762.           contains several *.COM files  which  use  some of these sequences
  11763.           and are provided as examples of this technique.
  11764.  
  11765.  
  11766.  
  11767.  
  11768.                          Automatic File Upload and Download
  11769.  
  11770.  
  11771.                   First are two private sequences  which  perform  the same
  11772.           effect as if the user had pressed:
  11773.  
  11774.           CTRL-F3         Receive File    ESC [ ? 2 1 h
  11775.           CTRL-F4         Transmit File   ESC [ ? 2 2 h
  11776.  
  11777.                   These would be useful  in  some  programed  file transfer
  11778.           routine which the user would only have to respond  to  a  program
  11779.           running  on  the  host.  It  would send down the escape  sequence
  11780.           without the user having to concern himself with it.
  11781.  
  11782.                   Any error condition which results from these commands can
  11783.           be accessed with the "ESC [ ? 1 0 n" report sequence described in
  11784.           more detail below.
  11785.  
  11786.  
  11787.  
  11788.  
  11789.                               Sending a Carriage Return
  11790.  
  11791.  
  11792.                   This private sequence, causes PC-VT  to  send  a carriage
  11793.           return (ASCII 13) to the host.
  11794.  
  11795.           Send CR         ESC [ ? 2 3 h
  11796.  
  11797.  
  11798.  
  11799.  
  11800.                            Filename Download from the Host
  11801.                                          and
  11802.                                   The Prearm Buffer
  11803.  
  11804.  
  11805.                   Another pair of escape codes does something a little more
  11806.           complicated. When you start  a  file  transfer, PC-VT always asks
  11807.           the user to type in the PC's filename. With these  two sequences,
  11808.           you a can set up PC-VT with a filename from the host. Then when a
  11809.  
  11810.  
  11811.           Page 174
  11812.  
  11813.  
  11814.  
  11815.  
  11816.  
  11817.  
  11818.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11819.  
  11820.  
  11821.           file transfer is started, PC-VT  pulls this filename out and puts
  11822.           it in the keyboard buffer just  as  if  the user had typed it in.
  11823.           Start the prearm buffer load with the sequence:
  11824.  
  11825.           Start buffer    ESC [ ? 2 4 h
  11826.  
  11827.           Then send the filename  with  the  "=a",  "=A", "=x", "=c", "=t",
  11828.           "=v", or "=k" on the end. Since PC-VT's file  transfer  mode  can
  11829.           default to a mode selected by the user, the  host  should  ALWAYS
  11830.           send down the mode after the  equal  sign. You may put a carriage
  11831.           return at the end just as the user would type it in but it is not
  11832.           required. The  maximum buffer size is 80 characters including the
  11833.           carriage  return  but  DOS  legal  filenames are a maximum of  66
  11834.           characters. Excess characters are ignored. You cannot download an
  11835.           escape character into the buffer. Then end it with this:
  11836.  
  11837.           End buffer      ESC [ ? 2 4 l
  11838.  
  11839.           Now if you send down a start file receive sequence:
  11840.  
  11841.           Receive File    ESC [ ? 2 1 h
  11842.  
  11843.                   PC-VT uses  the filename which you sent. Since the buffer
  11844.           is loaded with a filename, PC-VT won't prompt the  user  for  the
  11845.           filename. If the downloaded  filename  already  exists on the PC,
  11846.           PC-VT renames the file  automatically  in  an  attempt to find an
  11847.           unused filename. PC-VT changes the last character of the filename
  11848.           to the digits '0' through '9' in sequence, looking for  an unused
  11849.           name. If it finds one, it informs the user and continues with the
  11850.           receive file command using that  name.  Otherwise  it  aborts the
  11851.           transfer and either a  CTRL-Y  or  CTRL-D character (depending on
  11852.           Operating System selection) to the host followed by a CTRL-X.
  11853.  
  11854.                   On file transmit, if the requested file is not found, PC-
  11855.           VT  aborts  the  transfer and send  either  a  CTRL-Y  or  CTRL-D
  11856.           character (depending on Operating System selection)  to  the host
  11857.           followed by a CTRL-X.
  11858.  
  11859.                   With this scheme, the user would not have to type  in the
  11860.           PC's filename. The host  computer  can send it down the line. You
  11861.           can  see  that  this  can  be  useful  for  some  type  of  batch
  11862.           upload/download.
  11863.  
  11864.                   Here is what this might look like:
  11865.  
  11866.           ESC [ ? 2 4 h a:FILENAME.TXT=x CR ESC [ ? 2 4 l
  11867.           ESC [ ? 2 2 h
  11868.           (spaces shown for clarity only) <now PC-VT transmits
  11869.           the file a:FILENAME.TXT using the XMODEM protocol>
  11870.  
  11871.                   This sequence can be sent by the C language code:
  11872.  
  11873.           printf("\033[?24h%s\r\033[?24l\n\033[?22h",filename);
  11874.  
  11875.  
  11876.  
  11877.                                                                    Page 175
  11878.  
  11879.  
  11880.  
  11881.  
  11882.  
  11883.  
  11884.           Appendix J                                            PC-VT v10.0
  11885.  
  11886.  
  11887.                   If you are using KERMIT file transfer, you  can  load the
  11888.           prearm  buffer with a filename just  as  described  above.  PC-VT
  11889.           constructs a command line which  it passes to KERMIT. The command
  11890.           line looks like:
  11891.  
  11892.           rec  filename           : for download a file
  11893.           send filename           : for upload a file
  11894.  
  11895.           KERMIT returns to PC-VT as soon as the command is complete.
  11896.  
  11897.                   In  addition,  you  can  load  the prearm buffer  with  a
  11898.           complete command line for  KERMIT.  To do this, send a pound sign
  11899.           '#' down as the first character in the buffer and end  the buffer
  11900.           with '=k' as usual. PC-VT then starts up KERMIT and passes it the
  11901.           prearm buffer minus the  '#'  and '=k'. For example, you may want
  11902.           to  start  up  KERMIT,  have  it  display  STATUS  and then GET a
  11903.           wildcarded filename. You can send:
  11904.  
  11905.           ESC [ ? 2 4 h # status,get ab*.d* CR ESC [ ? 2 4 l
  11906.           ESC [ ? 2 2 h
  11907.           (spaces shown for clarity only except the one
  11908.           between the "get" and the filename)
  11909.           <now PC-VT starts up KERMIT and passes it that command line>
  11910.  
  11911.                   If you load PC-VT's  prearm  buffer  with the string #=k,
  11912.           KERMIT starts up in interactive mode.
  11913.  
  11914.                   To start Kermit from the host, send "ESC [ ? 2 2 l". This
  11915.           way is a little quicker than loading the prearm buffer with '#=k'
  11916.           as described above.
  11917.  
  11918.                   The attachment to  this PC-VT document describing KERMIT,
  11919.           shows all of the commands which KERMIT executes. The interface to
  11920.           KERMIT  is very general. When new versions  of  the  program  are
  11921.           available from Columbia  University,  you  can  just  replace the
  11922.           version included on the PC-VT distribution diskette.
  11923.  
  11924.                   Any error condition which results from these commands can
  11925.           be accessed with the "ESC [ ? 1 0 n" report sequence described in
  11926.           more detail below.
  11927.  
  11928.  
  11929.  
  11930.  
  11931.  
  11932.  
  11933.  
  11934.  
  11935.  
  11936.  
  11937.  
  11938.  
  11939.  
  11940.  
  11941.  
  11942.  
  11943.           Page 176
  11944.  
  11945.  
  11946.  
  11947.  
  11948.  
  11949.  
  11950.           PC-VT v10.0                                 VT100 & 4014 Emulator
  11951.  
  11952.  
  11953.  
  11954.  
  11955.  
  11956.  
  11957.                               Change Default Directory
  11958.  
  11959.  
  11960.                   This private  sequence  performs  the  same  function  as
  11961.           pressing CTRL-F2:
  11962.  
  11963.           Change Default Directory        ESC [ ? 2 5 h
  11964.  
  11965.           This causes PC-VT to ask for a new default  disk  directory.  The
  11966.           load prearm buffer sequence shown above can be used to set up PC-
  11967.           VT with a  directory  name.  If  an error is encountered when you
  11968.           download a directory name, the user is not informed but  an error
  11969.           code is available.
  11970.  
  11971.                   With  this scheme, you do not have to  type  in  the  new
  11972.           default directory. The host computer can send it  down  the line.
  11973.           You can see that this  can  be  useful  for  some  type  of batch
  11974.           upload/download.
  11975.  
  11976.                   Here is what this might look like:
  11977.  
  11978.           ESC [ ? 2 4 h a:\mydire\sub CR ESC [ ? 2 4 l
  11979.           ESC [ ? 2 5 h
  11980.           (spaces shown for clarity only)
  11981.           <now PC-VT changes the default directory to a:\mydir\sub>
  11982.  
  11983.                   This sequence can be sent by the C language code:
  11984.  
  11985.           printf("\033[?24h%s\r\033[?24l\n\033[?25h",directory);
  11986.  
  11987.                   Any error condition which results from  this  command can
  11988.           be accessed with the "ESC [ ? 1 0 n" report sequence described in
  11989.           more detail below.
  11990.  
  11991.  
  11992.  
  11993.  
  11994.                            Editor and OS Keyboard Support
  11995.  
  11996.  
  11997.                   These four  escape sequences let the host select the mode
  11998.           of keyboard  support. Sending these sequences has the same effect
  11999.           as if the user selected the corresponding options in the  SETUP B
  12000.           frame.
  12001.  
  12002.           Select EVE Keypad Support       ESC [ ? 2 8 h
  12003.           Select EDT Keypad Support       ESC [ ? 2 8 l
  12004.           Select VMS O/S Support          ESC [ ? 2 9 h
  12005.           Select UNIX O/S Support         ESC [ ? 2 9 l
  12006.  
  12007.  
  12008.  
  12009.                                                                    Page 177
  12010.  
  12011.  
  12012.  
  12013.  
  12014.  
  12015.  
  12016.           Appendix J                                            PC-VT v10.0
  12017.  
  12018.  
  12019.                               Terminate PC-VT Remotely
  12020.  
  12021.  
  12022.                   You can cause PC-VT to terminate by sending
  12023.  
  12024.           ESC [ ? 2 6 h
  12025.  
  12026.           This is the same pressing CTRL-F8 on the keyboard.
  12027.  
  12028.  
  12029.  
  12030.  
  12031.                                 Start Up Command.COM
  12032.  
  12033.  
  12034.                   You  can   cause  PC-VT  to  start  up  another  copy  of
  12035.           Command.COM by sending either:
  12036.  
  12037.           ESC [ ? 2 7 h
  12038.           or
  12039.           ESC [ ? 2 7 l
  12040.  
  12041.                   This  is  the  same as pressing ALT-F on the keyboard. If
  12042.           Command.COM is started in  this  way,  it runs interactively. You
  12043.           must still type in the word "exit" to return to PC-VT.
  12044.  
  12045.                   The second escape sequence  causes  PC-VT  to  wait after
  12046.           Command.COM has completed before the  emulator  starts  up again.
  12047.           The user is prompted to press a key to continue.
  12048.  
  12049.                   You can also load the prearm buffer with a DOS command to
  12050.           be executed. Anything that you can normally type in  at  the  DOS
  12051.           prompt can be downloaded. In order for this to operate correctly,
  12052.           you must begin the command with "/c". This is  a  requirement  of
  12053.           DOS. You can execute any DOS internal command like  COPY  or  you
  12054.           can  execute  a  program like BASICA. DOS uses the current search
  12055.           path to find the program.
  12056.  
  12057.                   Here is what this might look like:
  12058.  
  12059.           ESC [ ? 2 4 h /cbasica myprog ESC [ ? 2 4 l
  12060.           ESC [ ? 2 7 h
  12061.           (spaces shown for clarity only except the
  12062.           ones in the DOS command itself) <now PC-VT executes
  12063.           the BASICA program named myprog>
  12064.  
  12065.                   or
  12066.  
  12067.           ESC [ ? 2 4 h /ccopy a:\dir\dir2\file1.dat e:\ableESC [ ? 2 4 l
  12068.           ESC [ ? 2 7 h
  12069.           (spaces shown for clarity only except the
  12070.           ones in the DOS command itself) <now PC-VT executes
  12071.           DOS COPY command with the two files given>
  12072.  
  12073.  
  12074.  
  12075.           Page 178
  12076.  
  12077.  
  12078.  
  12079.  
  12080.  
  12081.  
  12082.           PC-VT v10.0                                 VT100 & 4014 Emulator
  12083.  
  12084.  
  12085.                   Any error condition which results from  this  command can
  12086.           be accessed with the "ESC [ ? 1 0 n" report sequence described in
  12087.           more detail below.
  12088.  
  12089.  
  12090.  
  12091.  
  12092.                                Starting Help Remotely
  12093.  
  12094.  
  12095.                   You  can  cause  PC-VT  to  start up the HELP feature  by
  12096.           sending:
  12097.  
  12098.           ESC [ ? 2 6 l
  12099.  
  12100.                   This is the same as pressing ALT-H on the keyboard. Press
  12101.           the Esc key to return to PC-VT.
  12102.  
  12103.                   Any error condition which results from  this  command can
  12104.           be accessed with the "ESC [ ? 1 0 n" report sequence described in
  12105.           more detail below.
  12106.  
  12107.  
  12108.  
  12109.  
  12110.                               Ignoring Escape Sequences
  12111.  
  12112.  
  12113.                   You can cause PC-VT to start ignoring escape sequences by
  12114.           sending:
  12115.  
  12116.           ESC [ ? 2 3 l
  12117.  
  12118.           Once the host sends  this  sequence, you must reset the option in
  12119.           the SETUP B frame manually or terminate and restart PC-VT.
  12120.  
  12121.  
  12122.  
  12123.  
  12124.                                      Error Codes
  12125.  
  12126.  
  12127.                   A private escape sequence returns  the  last  error which
  12128.           PC-VT encountered. The sequence is:
  12129.  
  12130.           ESC [ ? 1 0 n
  12131.  
  12132.                   PC-VT responds with:
  12133.  
  12134.           ESC [ ? x x x ; y y y n
  12135.  
  12136.           where xxx is three ASCII  characters  which  represent  the error
  12137.           code/return  code  and  yyy  is  three  ASCII   characters  which
  12138.  
  12139.  
  12140.  
  12141.                                                                    Page 179
  12142.  
  12143.  
  12144.  
  12145.  
  12146.  
  12147.  
  12148.           Appendix J                                            PC-VT v10.0
  12149.  
  12150.  
  12151.           represent the termination code. Once  these  codes  are returned,
  12152.           PC-VT resets them to zero.
  12153.  
  12154.                   If you are going to use this feature,  you  should always
  12155.           read the code before you start in order to make  sure  that it is
  12156.           reset to zero.
  12157.  
  12158.                   The error/return and termination  codes  are  set  by the
  12159.           following actions from the host:
  12160.  
  12161.             1.  Any printer  action if the printer is unavailable, off line
  12162.                 or runs out  of  paper.  The  error code is the status byte
  12163.                 returned by the BIOS,
  12164.  
  12165.             2.  Receipt of the escape  sequence  which  redefines  the PC's
  12166.                 keyboard.
  12167.  
  12168.             3.  Receipt of the escape sequence which invokes KERMIT,
  12169.  
  12170.             4.  Receipt of escape sequences which invoke any file transfer,
  12171.  
  12172.             5.  Receipt of the escape sequence which invokes HELP,
  12173.  
  12174.             6.  Receipt  of the escape sequence which invokes  COMMAND.COM,
  12175.                 or
  12176.  
  12177.             7.  Receipt  of  the   escape  sequence  which  invokes  change
  12178.                 directory.
  12179.  
  12180.                   Error codes which are returned as xxx are  in  most cases
  12181.           the  code  which DOS returns to PC-VT.  There  are  a  few  PC-VT
  12182.           extensions. The termination  code,  yyy, is zero. The error codes
  12183.           are:
  12184.  
  12185.                   ERROR
  12186.                   CODE
  12187.                   (xxx)   CONDITION
  12188.                   1       Invalid function
  12189.                   2       File not found
  12190.                   3       Path not found
  12191.                   4       Too many open files
  12192.                   5       Access denied
  12193.                   8       Insufficient memory
  12194.                   15      Invalid drive
  12195.                   100     Disk full
  12196.                   101     XMODEM error limit exceeded
  12197.                   102     Duplicate filename found during Receive file
  12198.  
  12199.                   Consult the DOS manual for other error codes.
  12200.  
  12201.                   The return code  is  produced  by  sequences  which start
  12202.           other  programs  such  as KERMIT and Command.COM. The code is the
  12203.           value which the called program returns in AL  when  it terminates
  12204.  
  12205.  
  12206.  
  12207.           Page 180
  12208.  
  12209.  
  12210.  
  12211.  
  12212.  
  12213.  
  12214.           PC-VT v10.0                                 VT100 & 4014 Emulator
  12215.  
  12216.  
  12217.           via  the  DOS  call  4Ch.  For  xxx  to be  a  return  code,  the
  12218.           termination code, yyy, must be greater than 100.
  12219.  
  12220.                   The termination code is also produced by  sequences which
  12221.           start other programs such as  KERMIT  and  Command.COM.  The code
  12222.           values are:
  12223.  
  12224.                   TERMINATION
  12225.                   CODE
  12226.                   (yyy)   CONDITION
  12227.                   000     xxx is an error code not a program return code.
  12228.                   100     Normal termination/yyy is a program return code.
  12229.                   101     Terminated by CTRL-BREAK. yyy is a program
  12230.                           return code.
  12231.                   102     Terminated by Critical Device Error. yyy is a
  12232.                           program return code.
  12233.                   103     Terminated by DOS call 31h. yyy is a program
  12234.                           return code.
  12235.  
  12236.  
  12237.  
  12238.  
  12239.                                        Colors
  12240.  
  12241.  
  12242.                   PC-VT  can handle color in VT100 mode if  you  are  on  a
  12243.           color monitor.  The color must be set by the host computer.  Here
  12244.           are the escape sequences and the colors which they invoke:
  12245.  
  12246.           ESC [ 8 m       Invisible
  12247.           ESC [ 3 0 m     Black Foreground
  12248.           ESC [ 3 1 m     Red Foreground
  12249.           ESC [ 3 2 m     Green Foreground
  12250.           ESC [ 3 3 m     Yellow Foreground
  12251.           ESC [ 3 4 m     Blue Foreground
  12252.           ESC [ 3 5 m     Magenta Foreground
  12253.           ESC [ 3 6 m     Cyan Foreground
  12254.           ESC [ 3 7 m     White Foreground
  12255.           ESC [ 4 0 m     Black Background
  12256.           ESC [ 4 1 m     Red Background
  12257.           ESC [ 4 2 m     Green Background
  12258.           ESC [ 4 3 m     Yellow Background
  12259.           ESC [ 4 4 m     Blue Background
  12260.           ESC [ 4 5 m     Magenta Background
  12261.           ESC [ 4 6 m     Cyan Background
  12262.           ESC [ 4 7 m     White Background
  12263.  
  12264.                   Example to set red characters on a blue background:
  12265.  
  12266.           ESC [ 3 1 m ESC [ 4 4 m ESC [ 2 J ESC [7 H
  12267.  
  12268.                   Where ESC is the  escape  character  ASCII 27. Certain of
  12269.           these combinations, like black foreground characters  on  a black
  12270.           background, won't show anything on the display.
  12271.  
  12272.  
  12273.                                                                    Page 181
  12274.  
  12275.  
  12276.  
  12277.  
  12278.  
  12279.  
  12280.           Appendix J                                            PC-VT v10.0
  12281.  
  12282.  
  12283.                   Note that  setting the colors does not affect the current
  12284.           contents of the display. Only characters displayed  following the
  12285.           color setting sequences are in color. This is consistent with the
  12286.           other Select  Graphic Rendition sequences. To clear the screen to
  12287.           the new  background color, use the clear screen sequence followed
  12288.           by the home cursor sequence. By just using  the  color sequences,
  12289.           you can make portions of your output display in different colors.
  12290.  
  12291.                   Once color is set, sending the "ESC [ m" (reset) sequence
  12292.           uses these colors for the default attributes. If you want to make
  12293.           these selections permanent for the  next time that you run PC-VT,
  12294.           go to the SETUP A frame and select the "s"  option  to store this
  12295.           information on disk. Because of this, if you want  to  return  to
  12296.           normal white on black operation, you must send the "ESC  [  3 7 ;
  12297.           40 m" sequence. Juset  sending  a reset does not restore white on
  12298.           black.
  12299.  
  12300.                   Since these sequences set the default attributes  for the
  12301.           program (until you terminate PC-VT), to run the PC-VT in  a color
  12302.           mode, have your host computer send down the appropriate sequences
  12303.           during your logon.
  12304.  
  12305.  
  12306.  
  12307.  
  12308.                                    Printer Support
  12309.  
  12310.  
  12311.                   To send a formfeed to the printer send "ESC [ ? 2 5 l" or
  12312.           press the ALT-P key on the keyboard.
  12313.  
  12314.                   Since PC-VT does not normally  send  escape  sequences to
  12315.           the printer, there is  a  special way to get control sequences to
  12316.           the  printer.  Use  the prearm buffer sequences above to fill the
  12317.           prearm buffer with the necessary controls. Then send the "ESC [ ?
  12318.           3 i" sequence.
  12319.  
  12320.                   Any  underline  characters  in  the buffer are translated
  12321.           into the escape  character  (ASCII  27)  before it is sent to the
  12322.           printer.
  12323.  
  12324.           ESC [ ? 2 4 h _124x ESC [ ? 2 4 l
  12325.           ESC [ ? 3 i
  12326.           (spaces shown for clarity only)
  12327.  
  12328.           The characters Escape, 1, 2, 4, and x are sent to the printer.
  12329.  
  12330.  
  12331.  
  12332.  
  12333.  
  12334.  
  12335.  
  12336.  
  12337.  
  12338.  
  12339.           Page 182
  12340.  
  12341.  
  12342.  
  12343.  
  12344.  
  12345.  
  12346.           PC-VT v10.0                                 VT100 & 4014 Emulator
  12347.  
  12348.  
  12349.                                  4010/4014 Emulation
  12350.  
  12351.  
  12352.                   A special sequence was added  in the 4014 emulator of PC-
  12353.           VT.  Upon  receipt  of  ESC  DC4, PC-VT switches back into  VT100
  12354.           emulator mode. The screen  is  cleared  unless  the /b option was
  12355.           used on the command line.
  12356.  
  12357.  
  12358.  
  12359.  
  12360.                                  Ignored Characters
  12361.  
  12362.  
  12363.                   PC-VT  normally  ignores  00h  and  7FH  while  in  VT100
  12364.           emulation mode.  To have PC-VT place them into the communications
  12365.           buffer  where they are still ignored later  but  take  up  buffer
  12366.           space send : "ESC [ 2 4 l".
  12367.  
  12368.  
  12369.  
  12370.  
  12371.  
  12372.  
  12373.  
  12374.  
  12375.  
  12376.  
  12377.  
  12378.  
  12379.  
  12380.  
  12381.  
  12382.  
  12383.  
  12384.  
  12385.  
  12386.  
  12387.  
  12388.  
  12389.  
  12390.  
  12391.  
  12392.  
  12393.  
  12394.  
  12395.  
  12396.  
  12397.  
  12398.  
  12399.  
  12400.  
  12401.  
  12402.  
  12403.  
  12404.  
  12405.                                                                    Page 183
  12406.  
  12407.  
  12408.  
  12409.  
  12410.  
  12411.  
  12412.           Appendix J                                            PC-VT v10.0
  12413.  
  12414.  
  12415.  
  12416.  
  12417.  
  12418.  
  12419.  
  12420.  
  12421.  
  12422.  
  12423.  
  12424.  
  12425.  
  12426.  
  12427.  
  12428.  
  12429.  
  12430.  
  12431.  
  12432.  
  12433.  
  12434.  
  12435.  
  12436.  
  12437.  
  12438.  
  12439.  
  12440.  
  12441.  
  12442.  
  12443.  
  12444.  
  12445.  
  12446.  
  12447.  
  12448.  
  12449.  
  12450.  
  12451.  
  12452.  
  12453.  
  12454.  
  12455.  
  12456.  
  12457.  
  12458.  
  12459.  
  12460.  
  12461.  
  12462.  
  12463.  
  12464.  
  12465.  
  12466.  
  12467.  
  12468.  
  12469.  
  12470.  
  12471.           Page 184
  12472.  
  12473.  
  12474.  
  12475.  
  12476.  
  12477.  
  12478.           PC-VT v10.0                                 VT100 & 4014 Emulator
  12479.  
  12480.  
  12481.  
  12482.  
  12483.  
  12484.  
  12485.  
  12486.  
  12487.                                      Appendix K
  12488.  
  12489.                                User-Supported Software
  12490.  
  12491.  
  12492.                   This program and documentation are copyrighted by Mark C.
  12493.           DiVecchio.
  12494.  
  12495.                   Permission to copy:
  12496.  
  12497.                   Individuals, clubs and other non-profit organizations are
  12498.           granted permission by the author  to freely copy this program and
  12499.           documentation and share it with their members, so long as:
  12500.  
  12501.                 No price is  charged  for  the  software  or documentation.
  12502.                 However, a distribution cost may be charged for the cost of
  12503.                 the diskette, so long as it is not more than $9 total.
  12504.  
  12505.                 Club members are informed of the user-supported concept and
  12506.                 encouraged to support it with their registration fees.
  12507.  
  12508.                 The program and  documentation  are not modified in any way
  12509.                 and are always distributed together.
  12510.  
  12511.                   Schools, universities, and other non-profit organizations
  12512.           are granted permission  by  the  author  to copy PC-VT for use on
  12513.           other computers and at  other  locations  in the organization, so
  12514.           long as:
  12515.  
  12516.                 The full fee of $35 has been paid for the original  copy of
  12517.                 the program.
  12518.  
  12519.                 A usage fee of  $40  is  paid  for each additional building
  12520.                 where PC-VT will be  used.  Within  each building for which
  12521.                 the usage fee has been paid, PC-VT may be copied freely for
  12522.                 use on any other computer  in  that  building.  Contact the
  12523.                 author if you would like to make other arrangements.
  12524.  
  12525.                   Commercial users of this program are  required  to submit
  12526.           the registration fee. Commercial and  site  licenses  as  well as
  12527.           source code licenses (in MASM) are available. The site license is
  12528.           handled as a graduated per copy fee. Contact the author.
  12529.  
  12530.  
  12531.  
  12532.  
  12533.  
  12534.  
  12535.  
  12536.  
  12537.                                                                    Page 185
  12538.  
  12539.  
  12540.  
  12541.  
  12542.  
  12543.  
  12544.           Appendix K                                            PC-VT v10.0
  12545.  
  12546.  
  12547.           The User-Supported concept:
  12548.  
  12549.           User-Supported Software
  12550.  
  12551.                   If you are using this program and find it to be of value,
  12552.           your registration fee will be appreciated.  ($35 is suggested)
  12553.  
  12554.                   For a $55 registration  fee,  you  will receive a printed
  12555.           manual containing this complete document.
  12556.  
  12557.                   For California delivery, add 7.25% sales tax.
  12558.  
  12559.                                   Mark C. DiVecchio
  12560.                           Athena Systems Development Group
  12561.                          9888 Carroll Center Road  Suite 113
  12562.                                 San Diego, CA  92126
  12563.            (616) 549-4056               RBBS : (619) 549-3927
  12564.  
  12565.                   Regardless of whether you pay the  registration  fee, you
  12566.           are encouraged to use, copy and share this program.
  12567.  
  12568.                   User-supported software is an experiment  in distributing
  12569.           computer programs, based on these beliefs:
  12570.  
  12571.                 That the value and utility  of software is best assessed by
  12572.                 the user on his/her own system.
  12573.  
  12574.                 That the creation of  personal  computer  software  can and
  12575.                 should be supported by the computing community.
  12576.  
  12577.                 That copying of programs should be encouraged,  rather than
  12578.                 restricted.
  12579.  
  12580.                   Anyone may request a copy of this  user-supported program
  12581.           by  sending  one  blank 1.2Mb formatted disk (without DOS) or two
  12582.           blank 360Kb formatted  disks  to  the  author of the program.  An
  12583.           addressed, postage-paid return mailer must accompany the disk (no
  12584.           exceptions, please). A copy of the program, with documentation on
  12585.           the  disk, will be sent by return mail.  The program will carry a
  12586.           notice  suggesting  the  payment  of  a registration fee  to  the
  12587.           program's author.  Paying  that  registration  fee  is completely
  12588.           voluntary on the part of each non-commercial user.
  12589.  
  12590.                   You may also get a  copy directly from the Athena Systems
  12591.           Development Group BBS at (619) 549-3927. Check this BBS for newer
  12592.           versions of the program as well.
  12593.  
  12594.                   Free  distribution of software and voluntary payment  for
  12595.           its use eliminates  costs  for  advertising  and  copy protection
  12596.           schemes.
  12597.  
  12598.                   Users obtain quality software at reduced  cost.  They can
  12599.           try it out  before buying, and do so at their own pace and in the
  12600.  
  12601.  
  12602.  
  12603.           Page 186
  12604.  
  12605.  
  12606.  
  12607.  
  12608.  
  12609.  
  12610.           PC-VT v10.0                                 VT100 & 4014 Emulator
  12611.  
  12612.  
  12613.           comfort  of their own home or office.   The  best  programs  will
  12614.           survive, based purely on their quality and usefulness.
  12615.  
  12616.                   Please join the experiment.
  12617.  
  12618.                   If you believe  in  these ideals, the registration fee is
  12619.           solicited to help make them work.
  12620.  
  12621.                   If you have read this far, and are considering submitting
  12622.           the fee, you get a free tip. When you start up  PC-VT,  put  a /g
  12623.           after the program  name  -  pc-vt/g  - and the 'send money' frame
  12624.           won't  be  displayed  but  you   will   go   directly   into  the
  12625.           communications frame.
  12626.  
  12627.                   The following invoice is  provided  for  those of you who
  12628.           wish an invoice for your tax records.
  12629.  
  12630.  
  12631.  
  12632.  
  12633.  
  12634.  
  12635.  
  12636.  
  12637.  
  12638.  
  12639.  
  12640.  
  12641.  
  12642.  
  12643.  
  12644.  
  12645.  
  12646.  
  12647.  
  12648.  
  12649.  
  12650.  
  12651.  
  12652.  
  12653.  
  12654.  
  12655.  
  12656.  
  12657.  
  12658.  
  12659.  
  12660.  
  12661.  
  12662.  
  12663.  
  12664.  
  12665.  
  12666.  
  12667.  
  12668.  
  12669.                                                                    Page 187
  12670.  
  12671.  
  12672.  
  12673.  
  12674.  
  12675.  
  12676.           Appendix K                                            PC-VT v10.0
  12677.  
  12678.  
  12679.  
  12680.                                  --------------------
  12681.                                        INVOICE
  12682.                                  --------------------
  12683.  
  12684.  
  12685.  
  12686.  
  12687.                       Purchased from:
  12688.                            Mark C. DiVecchio
  12689.                            Athena Systems Development Group
  12690.                            9888 Carroll Center Road  Suite 113
  12691.                            San Diego, CA  92126
  12692.  
  12693.                DATE:     /     /                     Invoice No. 10.0
  12694.                --------------------------------------------------------------
  12695.                                                     PRICE     PRICE
  12696.                PRODUCT                    QTY       EACH      EXTENDED
  12697.                -------------------------  ---       -----     --------
  12698.  
  12699.                PC-VT Terminal Emulator
  12700.                   Registration Fee                  $35
  12701.                   v10.0
  12702.  
  12703.                PC-VT Terminal Emulator
  12704.                   Registration Fee
  12705.                   AND Printed Manual                $55
  12706.                   v10.0
  12707.  
  12708.                PC-VT Distribution Disk               $9
  12709.                   Includes Postage and
  12710.                   Handling
  12711.  
  12712.                Copy of PC-VT and Documentation      N/C
  12713.                   on your Preformatted 1.2Mb
  12714.                   Diskette Returned in your
  12715.                   Postage Paid Self Addressed
  12716.                   Mailer
  12717.                                        --------------------------------------
  12718.                                                   SUBTOTAL
  12719.  
  12720.                7.25% Sales Tax (CA Residents only)
  12721.  
  12722.                                        --------------------------------------
  12723.                                        PLEASE PAY THIS AMOUNT           TOTAL
  12724.                   -----------------------------------------------------------
  12725.  
  12726.                   Please make check payable to : Athena Systems Development
  12727.           Group.
  12728.  
  12729.                   You may retain this Invoice for your tax records.
  12730.  
  12731.  
  12732.  
  12733.  
  12734.  
  12735.           Page 188
  12736.  
  12737.  
  12738.  
  12739.  
  12740.  
  12741.  
  12742.  
  12743.  
  12744.  
  12745.  
  12746.  
  12747.  
  12748.  
  12749.  
  12750.  
  12751.                                           Index
  12752.  
  12753.  
  12754.                   ! - Parity Error            Answerback Message
  12755.                        Character 56              Setting 52
  12756.                   ! - Parity Error            Application Keypad
  12757.                        Character 166               Mode 20
  12758.                   # - Buffer Overflow         ASCII File Transfer
  12759.                        Character 166               with Handshake
  12760.                   132 Column Mode 13               67
  12761.                   4014                        Autoprint 59
  12762.                      Character Sets           Autorepeat
  12763.                        152                       Enabling 53
  12764.                      Coordinates 145          Autowrap
  12765.                      Terminal Status             Enabling 54
  12766.                        Byte 158
  12767.                   4014 Autoprint              B
  12768.                      Selecting 59             Backspace Key Code
  12769.                   4014 CR Effect                 Setting 56
  12770.                      Selecting 59             Beep 12
  12771.                   4014 Gin Termination        Bell 12
  12772.                      Selecting 59             BREAK
  12773.                   4014 Key                       Long 40
  12774.                      ARROW 99                 Buffer Size 166
  12775.                      BACKSPACE 99                Selecting 57
  12776.                      HOLD SCREEN 100          Bypass Character 67
  12777.                      NUL Character 161
  12778.                      PAGE KEY 99              C
  12779.                      RESET 99                 Cable
  12780.                      RUBOUT 99                   RS-232 Interface
  12781.                      Standard Keyboard             165
  12782.                        99                     CAPS LOCK 19, 100
  12783.                      To VT100 Mode 100        Capture Mode 71
  12784.                      TTY LOCK 100             Click 12, 103
  12785.                   4014 LF Effect              Color 181
  12786.                      Selecting 59                Permanently
  12787.                   4014 LOY                         Setting 182
  12788.                      Selecting 59                Selecting 119
  12789.                   4014 Page Full              COM Port
  12790.                      Selecting 58                Clearing 140
  12791.                   8 Bit ASCII                    Selecting 50, 57
  12792.                      Enabling 58              COM Port Addressing
  12793.                   8259 PIC 165                     165
  12794.                   8 Bit ASCII 165             Command Line Option
  12795.                                                  /c 13
  12796.                   A                              /d 12
  12797.                   Alpha character 20,            /e 13
  12798.                        36                        /g 12, 13
  12799.  
  12800.  
  12801.  
  12802.  
  12803.  
  12804.  
  12805.  
  12806.  
  12807.  
  12808.  
  12809.  
  12810.  
  12811.                      /h 13                    Emulator
  12812.                      /i 14                       Starting 4014
  12813.                      /l 13                         mode 129
  12814.                      /t 13                    Emulators
  12815.                   COMMAND.COM                    Changing from
  12816.                      Calling 40, 101               4014 to VT100
  12817.                   Command Line Option              100
  12818.                      /d 85                       Changing from
  12819.                   Communications                   4014 to VT100
  12820.                        Buffer Handling             156
  12821.                        166                    Error Codes 179
  12822.                   Crosshair Position          Error Messages 61
  12823.                        Report 158                Dialing Directory
  12824.                   CTRL-D Functions 64,             86
  12825.                        65, 71                    Macro Directory
  12826.                   CTRL-D Functions 66              94
  12827.                   CTRL-Z Functions 64,        Error Messages 105
  12828.                        65, 71                 ESC ? 156
  12829.                   CTRL-Z Functions 66         ESC CAN 155
  12830.                   Cursor Mode                 ESC DC2 156
  12831.                      Selecting 53             ESC DC4 156
  12832.                   Cursor Problem 164          ESC ENQ 157
  12833.                                               ESC ETB 155
  12834.                   D                           ESC FF 155
  12835.                   Default Directory           ESC SUB 155, 158
  12836.                      Changing 39, 77          Escape Sequences
  12837.                   Defaults                       Private 174
  12838.                      File Transfer            EVE Editor 32
  12839.                        Mode 49, 52, 63        Everex Edge 13
  12840.                   Del Character 17            Extra Byte 145
  12841.                   DEL implies LOY 147,
  12842.                        152                    F
  12843.                   DESQview 172                Fast Screen Update
  12844.                   Dialing Commands 81              167
  12845.                   Dialing Directory           File Capture Mode 71
  12846.                      Fetching 83              Fixed Disk 9
  12847.                      Saving 83                Frame
  12848.                   Dialing Facility 40            Communications 10
  12849.                   Dialing Key 79
  12850.                   DOS                         G
  12851.                      Gateway 101              GIN Mode 150
  12852.                   DOS Gateway 40
  12853.                   Drawing Mode                H
  12854.                      Defocused 153            Hang Up 41, 101
  12855.                      Setting 152              Hanging up the phone
  12856.                   Drawing Mode                     83
  12857.                      Write-Thru 153           HELP 40, 101, 140,
  12858.                   DTR                              168
  12859.                      Dropping 83              HERE IS 40
  12860.                                               High Resolution
  12861.                   E                                Graphics 13
  12862.                   Editor Selection            High Resolution
  12863.                        EDT/EVE 53                  Graphics 13
  12864.                   EDT Editor 25               Honk 97
  12865.  
  12866.  
  12867.  
  12868.  
  12869.  
  12870.  
  12871.  
  12872.  
  12873.  
  12874.  
  12875.  
  12876.  
  12877.                                               PCjr Function Keys
  12878.                   K                                168
  12879.                   KERMIT 76                   Prearm Buffer 175
  12880.                   Keyboard                    Printer
  12881.                      Redefinition 42
  12882.                   Keypad Support 20           Formfeed 182
  12883.                                                  Selecting 57
  12884.                   L                           Printer Echo
  12885.                   LCE Mode 151                   Selecting 39
  12886.                   Line Feed Characters        Printing the Screen
  12887.                        64                          39
  12888.                   Line Turnaround                4014 100, 155
  12889.                        Character 67
  12890.                   Linefeed Characters         R
  12891.                        55                     Receive a File
  12892.                   Local Echo                     =a option 72
  12893.                      Enabling 55, 139,           =c option 72
  12894.                        160                       =k option 72, 76
  12895.                   Logon Macros 81                =x option 72, 75
  12896.                   LPT                            Default Mode 49
  12897.                      Selecting 57             Receiving
  12898.                                                    (Downloading)
  12899.                   M                                Files 39
  12900.                   Macro Directory             Running Programs
  12901.                      Fetching 89                   from PC-VT 40,
  12902.                      Saving 89                     101
  12903.                   Macro Facility 40
  12904.                   Macro Keys 40, 89,          S
  12905.                        101                    Screen Background
  12906.                      Commands 91                 Selecting 53
  12907.                      Downloading 93           Screen Blanking 60
  12908.                   Margin Bell                 Screen Dump 18, 42
  12909.                      Enabling 53              SCRNDUMP.DAT 18, 42
  12910.                   Modem Parameters            Scroll Buffer 41,
  12911.                      Selecting 51                  170
  12912.                   Modem Speed                    Enabling 59
  12913.                      Selecting 50                Initiating 140
  12914.                   Monitor                     SCROLL LOCK 18, 100
  12915.                      Both 13                  SETUP
  12916.                      Default 14                  Defaults 53
  12917.                      Everex Edge 13              Key 39
  12918.                      Hercules Graphics           Saving 48
  12919.                        13                        Selecting
  12920.                                                    Defaults 48
  12921.                   N                              Selecting
  12922.                   NUM LOCK 19, 20                  Features 50
  12923.                                               SETUP Key 47
  12924.                   P                           Smart Macros 91
  12925.                   Page Full 58                Snow Screen Update
  12926.                   Parity Checking                  167
  12927.                      Enabling 56              Status Line 10, 18,
  12928.                   PC-VT= 9, 61, 86,                54, 103
  12929.                        90, 94                    Alpha character
  12930.                   PCjr 167                         103
  12931.  
  12932.  
  12933.  
  12934.  
  12935.  
  12936.  
  12937.  
  12938.  
  12939.  
  12940.  
  12941.  
  12942.  
  12943.                      CD 104                   Transmitting
  12944.                      CTS 104                       (Uploading)
  12945.                      DSR 104                       Files 39
  12946.                      KBD LOCKED 103
  12947.                      Local 103                U
  12948.                      Lx 104                   UK Character Set
  12949.                      On Line 103                 Selecting 54
  12950.                      P 104                    Underline Attribute
  12951.                      SCR 103                     Selecting 58
  12952.                      Vx.x 103
  12953.                      X 104                    V
  12954.                   Status Line                 Vectors
  12955.                      CAP 103                     Dark 145
  12956.                      NUM 103                  VI Editor 36
  12957.                   Stop Bits                   Viewing a file 76
  12958.                      Selecting 55             Viewing a file 65
  12959.                                               VMS 4.0 166
  12960.                   T                           VMS Line Editing 23
  12961.                   Tab Defaults                VT Key
  12962.                      Selecting 48                ARROWS 18
  12963.                   Tabs                           BACKSPACE 17
  12964.                      Clearing All 48             BREAK 39
  12965.                      Setting and                 DELETE 17
  12966.                        Clearing 47               HERE IS 19, 142
  12967.                   Tekpoints 97                   LINEFEED 18
  12968.                   Terminating PC-VT              NO SCROLL 18
  12969.                        15, 39                    NUL Character 18
  12970.                   Time of Day Clock              PF 20
  12971.                      Enabling 57                 SETUP 39
  12972.                   TopView 172                 VT100/VT102
  12973.                                                  Selecting 57
  12974.                   Transmit a File             VT52 Mode
  12975.                      =a option 65                Selecting 54
  12976.                      =c option 65
  12977.                      =k option 65             X
  12978.                      =t option 67             X Flag 40
  12979.                      =v option 65, 76         XMODEM 70, 75
  12980.                      =v option 76             XOFF-How to clear it
  12981.                      =x option 65                  40
  12982.                      =x option 70             XON/XOFF
  12983.                      =z option 65                Enabling 54
  12984.                      Default Mode 49
  12985.  
  12986.  
  12987.  
  12988.  
  12989.  
  12990.  
  12991.  
  12992.  
  12993.  
  12994.  
  12995.  
  12996.  
  12997.  
  12998.  
  12999.  
  13000.  
  13001.  
  13002.  
  13003.  
  13004.  
  13005.  
  13006.  
  13007.  
  13008.  
  13009.  
  13010.  
  13011.  
  13012.  
  13013.                                       Contents
  13014.  
  13015.  
  13016.  
  13017.  
  13018.  
  13019.                Chapter 1  Introduction                               1
  13020.                   1.1  General Terminal Emulation  . . . . . . . . . 1
  13021.                   1.2  VT100/VT102/VT52  . . . . . . . . . . . . . . 2
  13022.                   1.3  4010/4014 . . . . . . . . . . . . . . . . . . 4
  13023.  
  13024.                Chapter 2  Required Hardware and Software             7
  13025.  
  13026.                Chapter 3  Installing and Starting PC-VT              9
  13027.                   3.1  Installation  . . . . . . . . . . . . . . . . 9
  13028.                      3.1.1  Floppy Diskette Installation . . . . . . 9
  13029.                      3.1.2  Fixed Disk Installation  . . . . . . . . 9
  13030.                   3.2  Starting PC-VT  . . . . . . . . . . . . . .  10
  13031.                   3.3  Command Line Options  . . . . . . . . . . .  12
  13032.  
  13033.                Chapter 4  Stopping PC-VT                            15
  13034.  
  13035.                Chapter 5  VT100 Keyboard Assignments                17
  13036.                   5.1  Regular Key Mapping . . . . . . . . . . . .  17
  13037.                   5.2  Keypad Mapping  . . . . . . . . . . . . . .  20
  13038.                   5.3  VMS Line Editing Keypad Mapping . . . . . .  23
  13039.                   5.4  EDT Keypad Mapping  . . . . . . . . . . . .  25
  13040.                   5.5  EVE Keypad Mapping  . . . . . . . . . . . .  32
  13041.                   5.6  VI Keypad Mapping . . . . . . . . . . . . .  36
  13042.                   5.7  Control Function Keys . . . . . . . . . . .  39
  13043.                   5.8  ALT Keys  . . . . . . . . . . . . . . . . .  40
  13044.                   5.9  Scroll Buffer . . . . . . . . . . . . . . .  41
  13045.                   5.10  Keyboard Redefinition  . . . . . . . . . .  42
  13046.  
  13047.                Chapter 6  SETUP Frames                              47
  13048.                   6.1  SETUP A . . . . . . . . . . . . . . . . . .  47
  13049.                   6.2  SETUP B . . . . . . . . . . . . . . . . . .  49
  13050.                      6.2.1  SETUP B Features and Defaults  . . . .  52
  13051.  
  13052.                Chapter 7  The PARAMS.DAT File                       61
  13053.                   7.1  Creation  . . . . . . . . . . . . . . . . .  61
  13054.                   7.2  Location  . . . . . . . . . . . . . . . . .  61
  13055.                   7.3  Updating  . . . . . . . . . . . . . . . . .  61
  13056.                   7.4  Error Messages  . . . . . . . . . . . . . .  61
  13057.  
  13058.                Chapter 8  Transmitting and Receiving Files          63
  13059.                   8.1  Transmitting ASCII Files (Uploading)  . . .  63
  13060.                      8.1.1  Uploading with Handshake . . . . . . .  67
  13061.                      8.1.2  Example of a Transmission Session  . .  68
  13062.                      8.1.3  A Useful VAX .COM Upload File  . . . .  69
  13063.  
  13064.  
  13065.                                           i
  13066.  
  13067.  
  13068.  
  13069.  
  13070.  
  13071.  
  13072.  
  13073.  
  13074.  
  13075.                   8.2  Transmitting Binary Files (Uploading) . . .  70
  13076.                   8.3  Receiving ASCII Files (Downloading) . . . .  70
  13077.                      8.3.1  Example of a Receive Session . . . . .  73
  13078.                      8.3.2  A Useful VAX .COM Download File  . . .  73
  13079.                   8.4  Receiving Binary Files (Downloading)  . . .  75
  13080.                   8.5  Viewing Files . . . . . . . . . . . . . . .  76
  13081.                   8.6  KERMIT File Transfer  . . . . . . . . . . .  76
  13082.                   8.7  Changing the Default Directory  . . . . . .  77
  13083.  
  13084.                Chapter 9  DIALING Frame                             79
  13085.                   9.1  Dialing Instructions  . . . . . . . . . . .  79
  13086.                   9.2  Saving SETUP Information  . . . . . . . . .  84
  13087.                   9.3  Dialing From the DOS Command Line . . . . .  85
  13088.                   9.4  The DIALER.DAT File . . . . . . . . . . . .  85
  13089.                      9.4.1  Creation . . . . . . . . . . . . . . .  85
  13090.                      9.4.2  Location . . . . . . . . . . . . . . .  86
  13091.                      9.4.3  Updating . . . . . . . . . . . . . . .  86
  13092.                   9.5  Error Messages  . . . . . . . . . . . . . .  86
  13093.  
  13094.                Chapter 10  MACRO Frame                              89
  13095.                   10.1  Instructions for MACRO . . . . . . . . . .  89
  13096.                      10.1.1  Defining Macro Keys . . . . . . . . .  90
  13097.                      10.1.2  Sending Macros  . . . . . . . . . . .  91
  13098.                   10.2  Downloading Macro Keys . . . . . . . . . .  93
  13099.                   10.3  The MACRO.DAT File . . . . . . . . . . . .  94
  13100.                      10.3.1  Creation  . . . . . . . . . . . . . .  94
  13101.                      10.3.2  Location  . . . . . . . . . . . . . .  94
  13102.                      10.3.3  Updating  . . . . . . . . . . . . . .  94
  13103.                   10.4  Error Messages . . . . . . . . . . . . . .  94
  13104.  
  13105.                Chapter 11  4014 Emulation                           97
  13106.                   11.1  4014 Options . . . . . . . . . . . . . . .  98
  13107.                   11.2  4014 Keyboard Mapping  . . . . . . . . . .  99
  13108.                      11.2.1  Regular Key Mapping . . . . . . . . .  99
  13109.                      11.2.2  Control Function Keys . . . . . . . . 100
  13110.                      11.2.3  ALT Keys  . . . . . . . . . . . . . . 101
  13111.                   11.3  4014 Error Messages  . . . . . . . . . . . 101
  13112.  
  13113.                Chapter 12  PC-VT Status Line                       103
  13114.  
  13115.                Chapter 13  Error Messages                          105
  13116.  
  13117.                Appendix A  VT100 Control Characters                109
  13118.  
  13119.                Appendix B  VT100 Received Escape Sequences         113
  13120.  
  13121.                Appendix C  VT100 Transmitted Escape Sequences      133
  13122.  
  13123.                Appendix D  VT100 Responses to Escape Sequences     137
  13124.  
  13125.                Appendix E  VT100 Special ALT Key Definitions       139
  13126.  
  13127.                Appendix F  4014 Received Character Processing      143
  13128.                   F.1  Alpha Mode  . . . . . . . . . . . . . . . . 143
  13129.  
  13130.  
  13131.                                           ii
  13132.  
  13133.  
  13134.  
  13135.  
  13136.  
  13137.  
  13138.  
  13139.  
  13140.  
  13141.                   F.2  Graph Mode  . . . . . . . . . . . . . . . . 145
  13142.                   F.3  Bypass/GIN Mode . . . . . . . . . . . . . . 149
  13143.                   F.4  LCE Mode  . . . . . . . . . . . . . . . . . 151
  13144.  
  13145.                Appendix G  4014 Received Escape Sequences          155
  13146.  
  13147.                Appendix H  4014 Responses to Escape Sequences      157
  13148.  
  13149.                Appendix I  4014 Special Shift, ALT and CTRL Key
  13150.                            Definitions                             160
  13151.  
  13152.                Appendix J  PC-VT Technical Details                 163
  13153.                   J.1  Details . . . . . . . . . . . . . . . . . . 163
  13154.                   J.2  HELP Customization  . . . . . . . . . . . . 168
  13155.                   J.3  Miscellaneous . . . . . . . . . . . . . . . 170
  13156.                   J.4  DESQview and TopView  . . . . . . . . . . . 172
  13157.                   J.5  PC-VT Private Escape Sequences  . . . . . . 174
  13158.  
  13159.                Appendix K  User-Supported Software                 185
  13160.  
  13161.                Index                                               189
  13162.  
  13163.  
  13164.  
  13165.  
  13166.  
  13167.  
  13168.  
  13169.  
  13170.  
  13171.  
  13172.  
  13173.  
  13174.  
  13175.  
  13176.  
  13177.  
  13178.  
  13179.  
  13180.  
  13181.  
  13182.  
  13183.  
  13184.  
  13185.  
  13186.  
  13187.  
  13188.  
  13189.  
  13190.  
  13191.  
  13192.  
  13193.  
  13194.  
  13195.  
  13196.  
  13197.                                          iii
  13198.  
  13199.  
  13200.  
  13201.